Class ImageOrPrintOptions
名称: Aspose.Cells.Rendering 收集: Aspose.Cells.dll (25.4.0)
允许在将工作表转换为图像、打印工作表或将图表转换为图像时指定选项。
public class ImageOrPrintOptions
Inheritance
Examples
//Set Image Or Print Options
ImageOrPrintOptions options = new ImageOrPrintOptions();
//Set output image format
options.ImageType = ImageType.Png;
//Set Horizontal resolution
options.HorizontalResolution = 300;
//Set Vertical Resolution
options.VerticalResolution = 300;
//Instantiate Workbook
Workbook book = new Workbook("test.xls");
//Save chart as Image using ImageOrPrint Options
book.Worksheets[0].Charts[0].ToImage("chart.png", options);
'Set Image Or Print Options
Dim options As New ImageOrPrintOptions()
'Set output image format
options.ImageType = ImageType.Png
'Set Horizontal resolution
options.HorizontalResolution = 300
'Set Vertical Resolution
options.VerticalResolution = 300
'Instantiate Workbook
Dim book As New Workbook("test.xls")
'Save chart as Image using ImageOrPrint Options
book.Worksheets(0).Charts(0).ToImage("chart.png", options)
Constructors
ImageOrPrintOptions()
科特。
public ImageOrPrintOptions()
Properties
AllColumnsInOnePagePerSheet
如果 AllColumnsInOnePagePerSheet 是真实的,则单页的所有列内容将输出到一个单页的结果。页面设置的纸张大小将不适用,页面设置的其他设置将不适用。它将继续有效。
public bool AllColumnsInOnePagePerSheet { get; set; }
财产价值
ChartImageType
在转换时指示图表图像类型。默认值:PNG。
[Obsolete("Chart and Shape are always rendered as vector elements(e.g. point, line) for rendering quality.")]
[Browsable(false)]
public ImageFormat ChartImageType { get; set; }
财产价值
Remarks
注意:这个成员现在已经过时了。图表和形状始终以 vector 元素(例如点、线)为提供质量。该财产将于2022年6月12日以后撤销。阿斯波斯对您可能遇到的任何不适表示道歉。
CheckWorkbookDefaultFont
当 Excel 中的字符是 Unicode 并且不设置在单元格式的正确字体时,它们可以在PDF、图像中显示为区块。将此设置为真实,以便尝试使用工作簿的默认字体首先显示这些字符。
public bool CheckWorkbookDefaultFont { get; set; }
财产价值
Remarks
假设是真实的。
CustomPrintPageEventHandler
客户可以在使用此 EventHandler 打印每个页面时为打印提供特殊输出
public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }
财产价值
CustomQueryPageSettingsEventHandler
客户可以在使用此 EventHandler 打印每个页面时控制打印机的页面设置
public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }
财产价值
DefaultEditLanguage
获取或设置默认编辑语言。
public DefaultEditLanguage DefaultEditLanguage { get; set; }
财产价值
Remarks
它可以在设置不同的编辑语言时显示/传输文本段的不同配置。默认是 Aspose.Cells.DefaultEditLanguage.Auto。
DefaultFont
当 Excel 中的字符是 Unicode 并且不设置在单元格式的正确字体时,它们可以在PDF、图像中显示为区块。设置 DefaultFont 如 MingLiu 或 MS Gothic 以显示这些字符。如果此属性不设置, Aspose.Cells 将使用系统默认字体显示这些单码字符。
public string DefaultFont { get; set; }
财产价值
DrawObjectEventHandler
实施此界面,以获得 DrawObject 和 Bound 在播放时。
public DrawObjectEventHandler DrawObjectEventHandler { get; set; }
财产价值
EmbededImageNameInSvg
在 svg 中指示嵌入图像的字体名称。这应该是完整的路径与目录如“c:\xpsEmbedded”
[Obsolete("Images are always embedded in Svg with base64 format, please remove this property.")]
[Browsable(false)]
public string EmbededImageNameInSvg { get; set; }
财产价值
EmfRenderSetting
设置在源文件中显示 EMF 代码。
public EmfRenderSetting EmfRenderSetting { get; set; }
财产价值
Remarks
被称为“EMF+双”的 EMF 代码可以包含 EMF+ 记录和 EMF 记录。任何类型的记录都可以用于显示图像,仅限EMF+记录,或仅限EMF记录。当 Aspose.Cells.EmfRenderSetting.EmfPlusPrefer 设置时,EMF+ 记录将在图像中播放,否则只有 EMF 记录将播放。默认值是 Aspose.Cells.EmfRenderSetting.EmfOnly。对于依赖 .Net System.Drawing.Common 的框架,此设置被忽略。
EmfType
收到或设置一个 EmfType 指定 Metafile 的格式。
public EmfType EmfType { get; set; }
财产价值
GridlineType
接收或设置网格类型。
public GridlineType GridlineType { get; set; }
财产价值
Remarks
假设是Dotted类型。
HorizontalResolution
接收或设置创建图像的水平分辨率,每英寸点。
public int HorizontalResolution { get; set; }
财产价值
Examples
下面的代码设置分辨率为192,所产生的图像的宽度和高度为两倍。剩下的分辨率为默认值96。
Workbook wb = new Workbook("Book1.xlsx");
ImageOrPrintOptions opts = new ImageOrPrintOptions();
//Set output image type: png.
opts.ImageType = ImageType.Png;
//Set resolution to 192.
opts.HorizontalResolution = 192;
opts.VerticalResolution = 192;
//Render worksheet page to image.
SheetRender sr = new SheetRender(wb.Worksheets[0], opts);
sr.ToImage(0, "Sheet_Page1.png");
Remarks
默认值为96。
设置 Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution 和 Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution 影响输出图像的宽度和高度在像素。
ImageType
接收或设置所产生的图像格式。默认值:PNG。
public virtual ImageType ImageType { get; set; }
财产价值
IsCellAutoFit
它表明细胞的宽度和高度是否自动定义为单元值。默认值是虚假的。
[Obsolete("Use Worksheet.AutoFitColumns(AutoFitterOptions) and Worksheet.AutoFitRows(AutoFitterOptions) instead.")]
[Browsable(false)]
public bool IsCellAutoFit { get; set; }
财产价值
Remarks
注意:这个成员现在已经过时了。请使用 Aspose.Cells.Worksheet.AutoFitColumns(_W L 27.AutofitterOptions) 和 __ WL 27 _.Toolsheet。该财产将于2022年8月12日以后撤销。阿斯波斯对您可能遇到的任何不适表示道歉。
IsFontSubstitutionCharGranularity
表示是否只能替换字体字体,当细胞字体不兼容时。
public bool IsFontSubstitutionCharGranularity { get; set; }
财产价值
Remarks
我们将尝试默认字体的Workbook和PdfSaveOption/系统的细胞字体首先。
IsOptimized
表示是否要优化输出元素。
public bool IsOptimized { get; set; }
财产价值
Remarks
假值是假的。目前,当此属性实现时,将进行以下优化:
- 优化边境线。
- 优化文件大小,同时转换为 Svg 图像。
OnePagePerSheet
如果 OnePagePerSheet 是真实的,则单页的所有内容都会输出到一个单页的结果。页面设置的纸张大小将无效,页面设置的其他设置将无效。它将继续有效。
public bool OnePagePerSheet { get; set; }
财产价值
OnlyArea
如果这个属性是真实的,一个区域将是产量,没有规模将生效。
public bool OnlyArea { get; set; }
财产价值
OutputBlankPageWhenNothingToPrint
它表明是否要输出白页,当没有印刷的东西。
public bool OutputBlankPageWhenNothingToPrint { get; set; }
财产价值
Remarks
假设是假的。
PageCount
获取或设置要保存的页数。
public int PageCount { get; set; }
财产价值
Remarks
默认情况是 System.Int32.MaxValue,这意味着所有页面都将被转换。
PageIndex
获取或设置第一个页面以 0 为基础的索引。
public int PageIndex { get; set; }
财产价值
Remarks
假设是0。
PageSavingCallback
控制 / 显示页面保存过程的进展。
public IPageSavingCallback PageSavingCallback { get; set; }
财产价值
PixelFormat
接收或设置为创建的图像的像素格式。
public PixelFormat PixelFormat { get; set; }
财产价值
Remarks
默认值是 PixelFormat.Format32bppArgb。
PrintWithStatusDialog
如果 PrintWithStatusDialog = true ,则会有一个对话,显示当前的打印状态。否则,这样的对话不会出现。
public bool PrintWithStatusDialog { get; set; }
财产价值
PrintingPage
表示哪些页面不会打印。
public PrintingPageType PrintingPage { get; set; }
财产价值
Quality
收到或设置决定创建图像的质量的值,仅适用于保存页面到“Jpeg”格式时。
public int Quality { get; set; }
财产价值
Remarks
只有在 JPEG 存储时才有效。值必须在 0 到 100 之间。默认值为100。
SVGFitToViewPort
如果此属性是真实的,则所产生的 svg 将适合参观港口。
[Obsolete("Use SvgImageOptions.FitToViewPort property instead.")]
[Browsable(false)]
public bool SVGFitToViewPort { get; set; }
财产价值
SaveFormat
获取或设置输出文件格式类型支持 Tiff/XPS
[Obsolete("For Tiff/Svg, use ImageType; For Xps, use Workbook.Save(string, SaveOptions) with XpsSaveOptions")]
[Browsable(false)]
public SaveFormat SaveFormat { get; set; }
财产价值
Remarks
注意:这个成员现在已经过时了。对于 Tiff/Svg,请使用 Aspose.Cells.Rendering.ImageOrPrintOptions. ImageType;对于 Xps,使用 Wl27.Workbook.Save(System.String,W L 27。该财产将于2022年8月12日以后撤销。阿斯波斯对您可能遇到的任何不适表示道歉。
SheetSet
默认情况下,工作簿中的所有可见的页面都是: Aspose.Cells.Rendering.SheetSet.Visible。
public SheetSet SheetSet { get; set; }
财产价值
Remarks
在 Aspose.Cells.Rendering.SheetRender 中使用时,该集被忽略。
SmoothingMode
指定是否适用于线条和曲线以及填满区域的边缘。默认值是 SmoothingMode.None
public SmoothingMode SmoothingMode { get; set; }
财产价值
SvgCssPrefix
接收并在 svg 中设置 css 名称的预定,默认值是空行。
[Obsolete("Use SvgImageOptions.CssPrefix property instead.")]
[Browsable(false)]
public string SvgCssPrefix { get; set; }
财产价值
TextCrossType
获取或设置显示文本类型,当文本宽度大于细胞宽度时。
public TextCrossType TextCrossType { get; set; }
财产价值
TextRenderingHint
说明文本的质量。默认值是 TextRenderingHint.SystemDefault
public TextRenderingHint TextRenderingHint { get; set; }
财产价值
TiffBinarizationMethod
获取或设置在将图像转换为 1 bpp 格式时使用的方法当 Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType 是 Tiff 和 Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompression 等于 Ccitt3 或 Ccitt4.
public ImageBinarizationMethod TiffBinarizationMethod { get; set; }
财产价值
Remarks
默认值是 FloydSteinbergDithering。
TiffColorDepth
获取或设置点深仅适用于保存页面到“Tiff”格式时。
public ColorDepth TiffColorDepth { get; set; }
财产价值
Remarks
只有在 TIFF 节省时才有效。如果 TiffCompression 设置为 CCITT3, CCITT4,这将不会有效,生成的 Tiff 图像的点深将始终为 1.
TiffCompression
获取或设置压缩类型仅适用于保存页面到“Tiff”格式时。
public TiffCompression TiffCompression { get; set; }
财产价值
Remarks
只有在 TIFF 节省时才有效。默认值为Lzw。
Transparent
表明创建的图像背景是否应该透明。
public bool Transparent { get; set; }
财产价值
Remarks
默认值是虚假的,这意味着创建的图像的背景是白色的。
VerticalResolution
接收或设置创建图像的垂直分辨率,每英寸点。
public int VerticalResolution { get; set; }
财产价值
Examples
下面的代码设置分辨率为192,所产生的图像的宽度和高度为两倍。剩下的分辨率为默认值96。
Workbook wb = new Workbook("Book1.xlsx");
ImageOrPrintOptions opts = new ImageOrPrintOptions();
//Set output image type: png.
opts.ImageType = ImageType.Png;
//Set resolution to 192.
opts.HorizontalResolution = 192;
opts.VerticalResolution = 192;
//Render Chart to image.
wb.Worksheets[0].Charts[0].ToImage("Chart.png", opts);
Remarks
默认值为96。
设置 Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution 和 Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution 影响输出图像的宽度和高度在像素。
WarningCallback
收到或设置警告呼叫。
public IWarningCallback WarningCallback { get; set; }
财产价值
Methods
SetDesiredSize(int , int , int)
设置所需的宽度和图像高度。
[Obsolete("Use SetDesiredSize(int, int, bool) by setting param keepAspectRatio to false instead.")]
public void SetDesiredSize(int desiredWidth, int desiredHeight)
Parameters
desiredWidth
int
想要的宽度在像素中
desiredHeight
int
所需尺寸在像素中
Remarks
注意:这个成员现在已经过时了。请使用 Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) 设置参数保持AspectRatio 虚假。该房地产将于2023年5月12个月后撤销。阿斯波斯对您可能遇到的任何不适表示道歉。
SetDesiredSize(int , int , bool)
设置所需的宽度和图像高度。
public void SetDesiredSize(int desiredWidth, int desiredHeight, bool keepAspectRatio)
Parameters
desiredWidth
int
想要的宽度在像素中
desiredHeight
int
所需尺寸在像素中
keepAspectRatio
bool
是否要保持原始图像的视角比例
Remarks
在像素中输出图像的宽度和高度将仅基于所需的宽度和高度。
Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution 和 Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution 在这种情况下不会影响输出图像的宽度和高度。