AlexZ 发表于 2023-5-6 13:50:11

【GcExcel v6.1 新特性预览】导出图片时,通过 ImageSaveOptions 调整输出图像

背景
GcExcel 已经提供了一种使用 ToImage 方法将工作表、任何指定范围和各种形状类型转换为图像的方法。
GcExcel 现在还添加了 ImageSaveOptions 类,提供各种属性以在将工作表、范围或形状导出到图像文件时修改和调整图像。
有以下的选项:

[*]ScaleX and ScaleY
[*]Resolution
[*]BackgroundColor
[*]ShowRowHeadings
[*]ShowColumnHeadings
[*]ShowGridlines
[*]GridlinesColor
[*]ShowDrawingObjects
[*]BlackAndWhite

接口
以下设置用于 IWorksheet、IRange 或 IShape ToImage()。

[*]使用 ImageSaveOptions.ScaleX 和 ImageSaveOptions.ScaleY 获取或设置比例。
[*]使用 ImageSaveOptions.Resolution 获取或设置 jpeg 文件 dpi,其他图像格式将忽略此属性。
[*]使用 ImageSaveOptions.BackgroundColor 获取或设置导出图像的背景颜色。
[*]使用 ImageSaveOptions.BlackAndWhite 获取或设置是否导出黑白图像。
以下设置仅用于 IWorksheet 或 IRange ToImage()。

[*]使用 ImageSaveOptions.ShowRowHeadings 或 ImageSaveOptions.ShowColumnHeadings 获取或设置是否显示行标题或列标题。
[*]使用 ImageSaveOptions.ShowGridlines 获取或设置是否显示网格线。
[*]使用 ImageSaveOptions.ShowDrawingObjects 获取或设置是否显示绘图对象(图表、形状和图片)。
[*]使用 ImageSaveOptions.GridlineColor 获取或设置网格线颜色。
添加一组支持 ImageSaveOptions 参数的新方法。

[*]使用 IWorksheet.ToImage(string imageFile, ImageSaveOptions options) 或 IWorksheet.ToImage(Stream stream, ImageType imageType, ImageSaveOptions options) 使用选项将工作表导出到图像文件。
[*]使用 IRange.ToImage(string imageFile, ImageSaveOptions options) 或 IRange.ToImage(Stream stream, ImageType imageType, ImageSaveOptions options) 使用选项将范围导出到图像文件。
[*]使用 IShape.ToImage(string fileName, ImageSaveOptions options) 或 IShape.ToImage(Stream stream, ImageType imageType, ImageSaveOptions options) 使用选项将形状导出到图像文件。


代码示例
以下代码设置导出工作表图像的背景颜色并设置网格线颜色
ImageSaveOptions options = new ImageSaveOptions();
// Set the background color of the exported image
options.BackgroundColor = Color.FromArgb(226, 231, 243);
// Set the gridlines of the exported image
options.ShowGridlines = true;
options.GridlineColor = Color.FromArgb(145, 167, 214);
worksheet.ToImage(outputStream, Drawing.ImageType.PNG, options);


页: [1]
查看完整版本: 【GcExcel v6.1 新特性预览】导出图片时,通过 ImageSaveOptions 调整输出图像