ImageOrPrintOptions类
ImageOrPrintOptions类
允许在将工作表渲染为图像、打印工作表或将图表渲染为图像时指定选项。
ImageOrPrintOptions 类型公开了以下成员：
构造器
| 构造器 | 描述 |
|---|---|
| ImageOrPrintOptions() | 构造 ImageOrPrintOptions 的新实例 |
特性
| 属性 | 描述 |
|---|---|
| save_format | 获取或设置输出文件格式类型
支持Tiff/XPS |
| print_with_status_dialog | 如果 PrintWithStatusDialog = true ，将出现一个显示当前打印状态的对话框。
否则不会显示这样的对话框。 |
| horizontal_resolution | 获取或设置生成图像的水平分辨率，以每英寸点数为单位。
应用除 Emf 格式图像之外的图像生成方法。 |
| vertical_resolution | 获取或设置生成图像的垂直分辨率，以每英寸点数为单位。
应用除 Emf 格式图像之外的图像生成方法。 |
| tiff_compression | 获取或设置仅在将页面保存为 Tiff 格式时应用的压缩类型。 |
| tiff_color_depth | 获取或设置位深度以仅在将页面保存为 Tiff 格式时应用。 |
| printing_page | 指示将不打印哪些页面。 |
| quality | 获取或设置确定生成图像质量的值
仅在将页面保存为 Jpeg 格式时应用。默认值为 100 |
| image_type | 获取或设置生成图像的格式。
默认值：PNG。 |
| is_cell_auto_fit | 指示单元格的宽度和高度是否由单元格值自动拟合。
默认值为假。 |
| one_page_per_sheet | 如果 OnePagePerSheet 为 true ，结果中一张纸的所有内容将只输出一页。
pagesetup的纸张大小会失效，pagesetup的其他设置 仍然会生效。 |
| all_columns_in_one_page_per_sheet | 如果 AllColumnsInOnePagePerSheet 为 true ，则一张工作表的所有列内容将仅输出到一页结果。
pagesetup的paper size的宽度会失效，pagesetup的其他设置 仍然会生效。 |
| draw_object_event_handler | 实现该接口，在渲染时获取DrawObject和Bound。 |
| chart_image_type | 转换时指明图表图像类型。
默认值：PNG。 |
| embeded_image_name_in_svg | 指示 svg 中嵌入图像的文件名。
这应该是目录的完整路径，如“c:\xpsEmbedded” |
| svg_fit_to_view_port | 如果此属性为真，则生成的 svg 将适合视口。 |
| only_area | 如果该属性为 true ，则输出一个 Area，不影响缩放。 |
| text_rendering_hint | 指定文本呈现的质量。
默认值为 TextRenderingHint.SystemDefault |
| smoothing_mode | 指定是否将平滑（抗锯齿）应用于直线和曲线以及填充区域的边缘。
默认值为 SmoothingMode.None |
| transparent | 指示生成图像的背景是否应该是透明的。 |
| pixel_format | 获取或设置生成图像的像素格式。 |
| warning_callback | 获取或设置警告回调。 |
| page_saving_callback | 控制/指示页面保存过程的进度。 |
| is_font_substitution_char_granularity | 指示当单元格字体不兼容时是否仅替换字符的字体。 |
| page_index | 获取或设置要保存的第一个页面的从 0 开始的索引。 |
| page_count | 获取或设置要保存的页数。 |
| is_optimized | 指示是否优化输出元素。 |
| default_font | 当Excel中的字符是Unicode且未在单元格样式中设置正确的字体时，
它们可能在 pdf、图像中显示为块。 设置 DefaultFont，例如 MingLiu 或 MS Gothic 以显示这些字符。 如果不设置该属性，Aspose.Cells 将使用系统默认字体来显示这些 unicode 字符。 |
| check_workbook_default_font | 当Excel中的字符是Unicode且未在单元格样式中设置正确的字体时，
它们可能在 pdf、图像中显示为块。 将此设置为 true 以尝试使用工作簿的默认字体首先显示这些字符。 |
| output_blank_page_when_nothing_to_print | 指示当没有可打印的内容时是否输出空白页。 |
| gridline_type | 获取或设置网格线类型。 |
| text_cross_type | 获取或设置当文本宽度大于单元格宽度时显示的文本类型。 |
| emf_type | 获取或设置指定图元文件格式的 EmfType。
默认值为 EmfPlusDual。 |
| default_edit_language | 获取或设置默认编辑语言。 |
| sheet_set | 获取或设置要呈现的工作表。默认为工作簿中的所有可见工作表：SheetSet.visible。 |
方法
| 方法 | 描述 |
|---|---|
| set_desired_size(desired_width, desired_height) | 设置所需的图像宽度和高度。 |
例子
from aspose.cells import Workbook
from aspose.cells.drawing import ImageType
from aspose.cells.rendering import ImageOrPrintOptions
# Set Image Or Print Options
options = ImageOrPrintOptions()
# Set output image format
options.image_type = ImageType.PNG
# Set Horizontal resolution
options.horizontal_resolution = 300
# Set Vertical Resolution
options.vertical_resolution = 300
# Instantiate Workbook
book = Workbook("test.xls")
# Save chart as Image using ImageOrPrint Options
book.worksheets[0].charts[0].to_image("chart.png", options)
