CompressImage

CompressImage(bool, PicturesCompression)

Komprimiert das Bild, indem seine Größe basierend auf der Formgröße und der angegebenen Auflösung reduziert wird. Optional werden auch beschnittene Bereiche gelöscht.

public bool CompressImage(bool deleteCroppedAreasOfImage, PicturesCompression resolution)
ParameterTypBeschreibung
deleteCroppedAreasOfImageBooleanWenn true, entfernt die Methode die beschnittenen Bereiche des Bildes, wodurch die Größe möglicherweise weiter reduziert 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 verkleinert oder zugeschnitten wurde, andernfalls false.

Ausnahmen

AusnahmeBedingung
ArgumentExceptionWird ausgelöst, wenn die Auflösung keinen gültigen Wert hat.

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 wird, um die Größe eines Bildes in einer Präsentation zu reduzieren, indem eine Zielauflösung festgelegt und beschnittene Bereiche entfernt werden:

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

Siehe auch


CompressImage(bool, float)

Komprimiert das Bild, indem seine Größe basierend auf der Formgröße und der angegebenen Auflösung reduziert wird. Optional werden auch beschnittene Bereiche gelöscht.

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

Rückgabewert

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

Ausnahmen

AusnahmeBedingung
ArgumentExceptionWird ausgelöst, wenn die Auflösung keinen positiven Wert hat.

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 wird, um die Größe eines Bildes in einer Präsentation zu reduzieren, indem eine Zielauflösung festgelegt und beschnittene Bereiche entfernt werden:

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

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

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

Siehe auch