【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) 使用选项将形状导出到图像文件。
  

代码示例
以下代码设置导出工作表图像的背景颜色并设置网格线颜色

1. ImageSaveOptions options = new ImageSaveOptions();
   
2. // Set the background color of the exported image
   
3. options.BackgroundColor = Color.FromArgb(226, 231, 243);
   
4. // Set the gridlines of the exported image
   
5. options.ShowGridlines = true;
   
6. options.GridlineColor = Color.FromArgb(145, 167, 214);
   
7. worksheet.ToImage(outputStream, Drawing.ImageType.PNG, options);

复制代码