CompressImage

CompressImage(bool, PicturesCompression)

Komprimiert das Bild, indem die Größe basierend auf der Formgröße und der angegebenen Auflösung verringert wird. Optional werden auch beschnittene Bereiche entfernt.

public bool CompressImage(bool deleteCroppedAreasOfImage, PicturesCompression resolution)
ParameterTypBeschreibung
deleteCroppedAreasOfImageBooleanWenn wahr, entfernt die Methode die beschnittenen Bereiche des Bildes, wodurch die Größe möglicherweise weiter verringert wird.
resolutionPicturesCompressionDie Zielauflösung für die Komprimierung, angegeben als Wert des PicturesCompression Enums.

Rückgabewert

Ein Boolean, der angibt, ob das Bild erfolgreich komprimiert wurde. Gibt true zurück, wenn das Bild geändert oder zugeschnitten wurde, andernfalls false.

Ausnahmen

AusnahmeBedingung
ArgumentExceptionWird ausgelöst, wenn die Auflösung kein gültiger Wert ist.

Anmerkungen

Diese Methode ändert die Größe und Auflösung des Bildes ähnlich wie die Funktion “Bildformat -> Bilder komprimieren” in PowerPoint.

Beispiele

Das folgende Beispiel zeigt, wie die Methode CompressImage verwendet werden kann, um die Größe eines Bildes in einer Präsentation durch Festlegen einer Zielauflösung und das Entfernen von beschnittenen Bereichen zu verringern:

using (Presentation presentation = new Presentation("demo.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IPictureFrame picFrame = slide.Shapes[0] as IPictureFrame;
    // Komprimiert das Bild mit einer Zielauflösung von 150 DPI (Webauflösung) und entfernt beschnittene Bereiche
    bool result = picFrame.PictureFormat.CompressImage(true, PicturesCompression.Dpi150);
}

Siehe auch


CompressImage(bool, float)

Komprimiert das Bild, indem die Größe basierend auf der Formgröße und der angegebenen Auflösung verringert wird. Optional werden auch beschnittene Bereiche entfernt.

public bool CompressImage(bool deleteCroppedAreasOfImage, float resolution)
ParameterTypBeschreibung
deleteCroppedAreasOfImageBooleanWenn wahr, entfernt die Methode die beschnittenen Bereiche des Bildes, wodurch die Größe möglicherweise weiter verringert wird.
resolutionSingleDie Zielauflösung in DPI. Dieser Wert muss positiv sein und definiert, wie das Bild verändert wird.

Rückgabewert

Ein Boolean, der angibt, ob das Bild erfolgreich komprimiert wurde. Gibt true zurück, wenn das Bild geändert oder zugeschnitten wurde, andernfalls false.

Ausnahmen

AusnahmeBedingung
ArgumentExceptionWird ausgelöst, wenn die Auflösung kein positiver Wert ist.

Anmerkungen

Diese Methode ändert die Größe und Auflösung des Bildes ähnlich wie die Funktion “Bildformat -> Bilder komprimieren” in PowerPoint.

Beispiele

Das folgende Beispiel zeigt, wie die Methode CompressImage verwendet werden kann, um die Größe eines Bildes in einer Präsentation durch Festlegen einer Zielauflösung und das Entfernen von beschnittenen Bereichen zu verringern:

[C#]
using (Presentation presentation = new Presentation("demo.pptx"))
{
    ISlide slide = presentation.Slides[0];

    // Holt das PictureFrame
    IPictureFrame picFrame = slide.Shapes[0] as IPictureFrame;

    // Komprimiert das Bild mit einer Zielauflösung von 150 DPI (Webauflösung) und entfernt beschnittene Bereiche
    bool result=picFrame.PictureFormat.CompressImage(true, 150f); // Webauflösung
}

Siehe auch