CompressImage

CompressImage(bool, PicturesCompression)

Сжимает изображение, уменьшая его размер на основе размера фигуры и заданного разрешения. При необходимости также удаляет обрезанные области.

public bool CompressImage(bool deleteCroppedAreasOfImage, PicturesCompression resolution)
ПараметрТипОписание
deleteCroppedAreasOfImageBooleanЕсли true, метод удалит обрезанные области изображения, что может еще больше уменьшить его размер.
resolutionPicturesCompressionЦелевое разрешение для сжатия, указанное как значение перечисления PicturesCompression.

Возвращаемое значение

Логическое значение, указывающее, было ли изображение успешно сжато. Возвращает true, если изображение было изменено по размеру или обрезано, в противном случае false.

Исключения

исключениеусловие
ArgumentExceptionГенерируется, если разрешение не является допустимым значением.

Примечания

Этот метод изменяет размер и разрешение изображения, аналогично функции “Формат картинки -> Сжать изображения” в PowerPoint.

Примеры

Следующий пример демонстрирует, как использовать метод CompressImage, чтобы уменьшить размер изображения в презентации, установив целевое разрешение и удалив обрезанные области:

using (Presentation presentation = new Presentation("demo.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IPictureFrame picFrame = slide.Shapes[0] as IPictureFrame;
    // Сжать изображение с целевым разрешением 150 DPI (веб-разрешение) и удалить обрезанные области
    bool result = picFrame.PictureFormat.CompressImage(true, PicturesCompression.Dpi150);
}

См. также

CompressImage(bool, float)

Сжимает изображение, уменьшая его размер на основе размера фигуры и заданного разрешения. При необходимости также удаляет обрезанные области.

public bool CompressImage(bool deleteCroppedAreasOfImage, float resolution)
ПараметрТипОписание
deleteCroppedAreasOfImageBooleanЕсли true, метод удалит обрезанные области изображения, что может еще больше уменьшить его размер.
resolutionSingleЦелевое разрешение в DPI. Это значение должно быть положительным и определяет, как будет изменено изображение.

Возвращаемое значение

Логическое значение, указывающее, было ли изображение успешно сжато. Возвращает true, если изображение было изменено по размеру или обрезано, в противном случае false.

Исключения

исключениеусловие
ArgumentExceptionГенерируется, если разрешение не является положительным значением.

Примечания

Этот метод изменяет размер и разрешение изображения, аналогично функции “Формат картинки -> Сжать изображения” в PowerPoint.

Примеры

Следующий пример демонстрирует, как использовать метод CompressImage, чтобы уменьшить размер изображения в презентации, установив целевое разрешение и удалив обрезанные области:

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

    // Получает PictureFrame
    IPictureFrame picFrame = slide.Shapes[0] as IPictureFrame;

    // Сжать изображение с целевым разрешением 150 DPI (веб-разрешение) и удалить обрезанные области
    bool result=picFrame.PictureFormat.CompressImage(true, 150f); // Веб-разрешение
}

См. также

TileScaleY DeletePictureCroppedAreas