ImageOrPrintOptions

ImageOrPrintOptions class

允许在将工作表渲染为图像、打印工作表或将图表渲染为图像时指定选项。

public class ImageOrPrintOptions

构造函数

姓名 描述
ImageOrPrintOptions() 默认构造函数。

特性

姓名 描述
AllColumnsInOnePagePerSheet { get; set; } 如果 AllColumnsInOnePagePerSheet 为 true ,则一张表的所有列内容将只输出到结果中的一页。 pagesetup 的纸张尺寸宽度将失效,pagesetup 的其他设置仍然有效。
CheckWorkbookDefaultFont { get; set; } 当 Excel 中的字符为 Unicode 且未在单元格样式中设置正确的字体时, 它们可能在 pdf、图像中显示为块。 将此设置为 true 以尝试使用工作簿的默认字体首先显示这些字符。
CustomPrintPageEventHandler { get; set; } 当使用这个EventHandler 打印每一页时,客户端可以特殊输出到打印机
CustomQueryPageSettingsEventHandler { get; set; } 客户端可以在使用此EventHandler 打印每一页时控制打印机的页面设置
DefaultEditLanguage { get; set; } 获取或设置默认编辑语言。
DefaultFont { get; set; } 当 Excel 中的字符为 Unicode 且未在单元格样式中设置正确的字体时, 它们可能在 pdf、图像中显示为块。 设置 DefaultFont,例如 MingLiu 或 MS Gothic 以显示这些字符。 如果此属性为未设置,Aspose.Cells 将使用系统默认字体显示这些 unicode 字符。
DrawObjectEventHandler { get; set; } 实现这个接口,在渲染的时候获取DrawObject和Bound。
EmbededImageNameInSvg { get; set; } 表示嵌入图像在 svg 中的文件名。 这应该是目录的完整路径,如“c:\xpsEmbedded”
EmfType { get; set; } 获取或设置一个 EmfType,它指定 Metafile 的格式.. 默认值为 EmfPlusDual。
GridlineType { get; set; } 获取或设置网格线类型。
HorizontalResolution { get; set; } 获取或设置生成图像的水平分辨率,以每英寸点数为单位。 应用生成图像的方法,除了 Emf 格式的图像。
ImageType { get; set; } 获取或设置生成图片的格式。 默认值:PNG。
IsCellAutoFit { get; set; } 表示单元格的宽度和高度是否由单元格值自动拟合。 默认值为false。
IsFontSubstitutionCharGranularity { get; set; } 表示是否仅在单元格字体不兼容时替换字符的字体。
IsOptimized { get; set; } 表示是否优化输出元素。
OnePagePerSheet { get; set; } 如果 OnePagePerSheet 为 true ,则一张表的所有内容将只输出到结果中的一页。 pagesetup 的纸张大小会失效,pagesetup 的其他设置仍然有效。
OnlyArea { get; set; } 如果该属性为true,则输出一个Area,没有比例尺生效。
OutputBlankPageWhenNothingToPrint { get; set; } 表示在没有可打印的内容时是否输出空白页。
PageCount { get; set; } 获取或设置要保存的页数。
PageIndex { get; set; } 获取或设置要保存的第一页的从0开始的索引。
PageSavingCallback { get; set; } 控制/指示页面保存过程的进度。
PixelFormat { get; set; } 获取或设置生成图像的像素格式。
PrintingPage { get; set; } 指示不打印哪些页面。
PrintWithStatusDialog { get; set; } 如果 PrintWithStatusDialog = true ,将会有一个显示当前打印状态的对话框。 否则不会显示这样的对话框。
Quality { get; set; } 获取或设置一个值,该值确定生成的图像的质量 仅在将页面保存到JPEG格式。默认值为 100
SaveFormat { get; set; } 获取或设置输出文件格式type 支持Tiff/XPS
SmoothingMode { get; set; } 指定是否对直线和曲线以及填充区域的边缘应用平滑(抗锯齿)。 默认值为 SmoothingMode.None
SVGFitToViewPort { get; set; } 如果此属性为真,生成的 svg 将适合查看端口。
TextCrossType { get; set; } 获取或设置文本宽度大于单元格宽度时显示的文本类型。
TextRenderingHint { get; set; } 指定文本渲染的质量。 默认值为TextRenderingHint.SystemDefault
TiffColorDepth { get; set; } 获取或设置仅在将页面保存到蒂夫格式。
TiffCompression { get; set; } 获取或设置仅在将页面保存到蒂夫格式.
Transparent { get; set; } 指示生成图像的背景是否应该是透明的。
VerticalResolution { get; set; } 获取或设置生成图像的垂直分辨率,以每英寸点数为单位。 应用除 Emf 格式图像之外的生成图像方法。
WarningCallback { get; set; } 获取或设置警告回调。

方法

姓名 描述
SetDesiredSize(int, int) 设置图像的所需宽度和高度。

例子


[C#]

//设置图像或打印选项
ImageOrPrintOptions options = new ImageOrPrintOptions();

//设置输出图像格式
options.ImageType = ImageType.Png;

//设置水平分辨率
options.HorizontalResolution = 300;

//设置垂直分辨率
options.VerticalResolution = 300;

//实例化工作簿
Workbook book = new Workbook("test.xls");

//使用 ImageOrPrint 选项将图表保存为图像
book.Worksheets[0].Charts[0].ToImage("chart.png", options);

[VB.NET]

'设置图像或打印选项
Dim options As New ImageOrPrintOptions()

'设置输出图像格式
options.ImageType = ImageType.Png

'设置水平分辨率
options.HorizontalResolution = 300

'设置垂直分辨率
options.VerticalResolution = 300

'实例化工作簿
Dim book As New Workbook("test.xls")

'使用 ImageOrPrint 选项将图表另存为图像
book.Worksheets(0).Charts(0).ToImage("chart.png", options)

也可以看看