Class ImageOrPrintOptions

Class ImageOrPrintOptions

名称: Aspose.Cells.Rendering 收集: Aspose.Cells.dll (25.4.0)

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

public class ImageOrPrintOptions

Inheritance

object ImageOrPrintOptions

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; }

财产价值

bool

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; }

财产价值

ImageFormat

Remarks

注意:这个成员现在已经过时了。图表和形状始终以 vector 元素(例如点、线)为提供质量。该财产将于2022年6月12日以后撤销。阿斯波斯对您可能遇到的任何不适表示道歉。

CheckWorkbookDefaultFont

当 Excel 中的字符是 Unicode 并且不设置在单元格式的正确字体时,它们可以在PDF、图像中显示为区块。将此设置为真实,以便尝试使用工作簿的默认字体首先显示这些字符。

public bool CheckWorkbookDefaultFont { get; set; }

财产价值

bool

Remarks

假设是真实的。

CustomPrintPageEventHandler

客户可以在使用此 EventHandler 打印每个页面时为打印提供特殊输出

public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }

财产价值

PrintPageEventHandler

CustomQueryPageSettingsEventHandler

客户可以在使用此 EventHandler 打印每个页面时控制打印机的页面设置

public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }

财产价值

QueryPageSettingsEventHandler

DefaultEditLanguage

获取或设置默认编辑语言。

public DefaultEditLanguage DefaultEditLanguage { get; set; }

财产价值

DefaultEditLanguage

Remarks

它可以在设置不同的编辑语言时显示/传输文本段的不同配置。默认是 Aspose.Cells.DefaultEditLanguage.Auto。

DefaultFont

当 Excel 中的字符是 Unicode 并且不设置在单元格式的正确字体时,它们可以在PDF、图像中显示为区块。设置 DefaultFont 如 MingLiu 或 MS Gothic 以显示这些字符。如果此属性不设置, Aspose.Cells 将使用系统默认字体显示这些单码字符。

public string DefaultFont { get; set; }

财产价值

string

DrawObjectEventHandler

实施此界面,以获得 DrawObject 和 Bound 在播放时。

public DrawObjectEventHandler DrawObjectEventHandler { get; set; }

财产价值

DrawObjectEventHandler

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; }

财产价值

string

EmfRenderSetting

设置在源文件中显示 EMF 代码。

public EmfRenderSetting EmfRenderSetting { get; set; }

财产价值

EmfRenderSetting

Remarks

被称为“EMF+双”的 EMF 代码可以包含 EMF+ 记录和 EMF 记录。任何类型的记录都可以用于显示图像,仅限EMF+记录,或仅限EMF记录。当 Aspose.Cells.EmfRenderSetting.EmfPlusPrefer 设置时,EMF+ 记录将在图像中播放,否则只有 EMF 记录将播放。默认值是 Aspose.Cells.EmfRenderSetting.EmfOnly。对于依赖 .Net System.Drawing.Common 的框架,此设置被忽略。

EmfType

收到或设置一个 EmfType 指定 Metafile 的格式。默认值是EmfPlusDual。

public EmfType EmfType { get; set; }

财产价值

EmfType

GridlineType

接收或设置网格类型。

public GridlineType GridlineType { get; set; }

财产价值

GridlineType

Remarks

假设是Dotted类型。

HorizontalResolution

接收或设置创建图像的水平分辨率,每英寸点。

public int HorizontalResolution { get; set; }

财产价值

int

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; }

财产价值

ImageType

IsCellAutoFit

它表明细胞的宽度和高度是否自动定义为单元值。默认值是虚假的。

[Obsolete("Use Worksheet.AutoFitColumns(AutoFitterOptions) and Worksheet.AutoFitRows(AutoFitterOptions) instead.")]
[Browsable(false)]
public bool IsCellAutoFit { get; set; }

财产价值

bool

Remarks

注意:这个成员现在已经过时了。请使用 Aspose.Cells.Worksheet.AutoFitColumns(_W L 27.AutofitterOptions) 和 __ WL 27 _.Toolsheet。该财产将于2022年8月12日以后撤销。阿斯波斯对您可能遇到的任何不适表示道歉。

IsFontSubstitutionCharGranularity

表示是否只能替换字体字体,当细胞字体不兼容时。

public bool IsFontSubstitutionCharGranularity { get; set; }

财产价值

bool

Remarks

我们将尝试默认字体的Workbook和PdfSaveOption/系统的细胞字体首先。

IsOptimized

表示是否要优化输出元素。

public bool IsOptimized { get; set; }

财产价值

bool

Remarks

假值是假的。目前,当此属性实现时,将进行以下优化:

  • 优化边境线。
  • 优化文件大小,同时转换为 Svg 图像。

OnePagePerSheet

如果 OnePagePerSheet 是真实的,则单页的所有内容都会输出到一个单页的结果。页面设置的纸张大小将无效,页面设置的其他设置将无效。它将继续有效。

public bool OnePagePerSheet { get; set; }

财产价值

bool

OnlyArea

如果这个属性是真实的,一个区域将是产量,没有规模将生效。

public bool OnlyArea { get; set; }

财产价值

bool

OutputBlankPageWhenNothingToPrint

它表明是否要输出白页,当没有印刷的东西。

public bool OutputBlankPageWhenNothingToPrint { get; set; }

财产价值

bool

Remarks

假设是假的。

PageCount

获取或设置要保存的页数。

public int PageCount { get; set; }

财产价值

int

Remarks

默认情况是 System.Int32.MaxValue,这意味着所有页面都将被转换。

PageIndex

获取或设置第一个页面以 0 为基础的索引。

public int PageIndex { get; set; }

财产价值

int

Remarks

假设是0。

PageSavingCallback

控制 / 显示页面保存过程的进展。

public IPageSavingCallback PageSavingCallback { get; set; }

财产价值

IPageSavingCallback

PixelFormat

接收或设置为创建的图像的像素格式。

public PixelFormat PixelFormat { get; set; }

财产价值

PixelFormat

Remarks

默认值是 PixelFormat.Format32bppArgb。

PrintWithStatusDialog

如果 PrintWithStatusDialog = true ,则会有一个对话,显示当前的打印状态。否则,这样的对话不会出现。

public bool PrintWithStatusDialog { get; set; }

财产价值

bool

PrintingPage

表示哪些页面不会打印。

public PrintingPageType PrintingPage { get; set; }

财产价值

PrintingPageType

Quality

收到或设置决定创建图像的质量的值,仅适用于保存页面到“Jpeg”格式时。

public int Quality { get; set; }

财产价值

int

Remarks

只有在 JPEG 存储时才有效。值必须在 0 到 100 之间。默认值为100。

SVGFitToViewPort

如果此属性是真实的,则所产生的 svg 将适合参观港口。

[Obsolete("Use SvgImageOptions.FitToViewPort property instead.")]
[Browsable(false)]
public bool SVGFitToViewPort { get; set; }

财产价值

bool

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; }

财产价值

SaveFormat

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; }

财产价值

SheetSet

Remarks

在 Aspose.Cells.Rendering.SheetRender 中使用时,该集被忽略。

SmoothingMode

指定是否适用于线条和曲线以及填满区域的边缘。默认值是 SmoothingMode.None

public SmoothingMode SmoothingMode { get; set; }

财产价值

SmoothingMode

SvgCssPrefix

接收并在 svg 中设置 css 名称的预定,默认值是空行。

[Obsolete("Use SvgImageOptions.CssPrefix property instead.")]
[Browsable(false)]
public string SvgCssPrefix { get; set; }

财产价值

string

TextCrossType

获取或设置显示文本类型,当文本宽度大于细胞宽度时。

public TextCrossType TextCrossType { get; set; }

财产价值

TextCrossType

TextRenderingHint

说明文本的质量。默认值是 TextRenderingHint.SystemDefault

public TextRenderingHint TextRenderingHint { get; set; }

财产价值

TextRenderingHint

TiffBinarizationMethod

获取或设置在将图像转换为 1 bpp 格式时使用的方法当 Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType 是 Tiff 和 Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompression 等于 Ccitt3 或 Ccitt4.

public ImageBinarizationMethod TiffBinarizationMethod { get; set; }

财产价值

ImageBinarizationMethod

Remarks

默认值是 FloydSteinbergDithering。

TiffColorDepth

获取或设置点深仅适用于保存页面到“Tiff”格式时。

public ColorDepth TiffColorDepth { get; set; }

财产价值

ColorDepth

Remarks

只有在 TIFF 节省时才有效。如果 TiffCompression 设置为 CCITT3, CCITT4,这将不会有效,生成的 Tiff 图像的点深将始终为 1.

TiffCompression

获取或设置压缩类型仅适用于保存页面到“Tiff”格式时。

public TiffCompression TiffCompression { get; set; }

财产价值

TiffCompression

Remarks

只有在 TIFF 节省时才有效。默认值为Lzw。

Transparent

表明创建的图像背景是否应该透明。

public bool Transparent { get; set; }

财产价值

bool

Remarks

默认值是虚假的,这意味着创建的图像的背景是白色的。

VerticalResolution

接收或设置创建图像的垂直分辨率,每英寸点。

public int VerticalResolution { get; set; }

财产价值

int

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; }

财产价值

IWarningCallback

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 在这种情况下不会影响输出图像的宽度和高度。

 中文