CompressImage

CompressImage(bool, PicturesCompression)

通过根据形状大小和指定的分辨率减少图像的大小来压缩图像。可选地，它还会删除裁剪区域。

public bool CompressImage(bool deleteCroppedAreasOfImage, PicturesCompression resolution)
参数类型描述
deleteCroppedAreasOfImage布尔值如果为真，则该方法将移除图像的裁剪区域，从而可能进一步减少其大小。
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)
参数类型描述
deleteCroppedAreasOfImage布尔值如果为真，则该方法将移除图像的裁剪区域，从而可能进一步减少其大小。
resolution单精度浮点数目标分辨率，以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