Class ImageOrPrintOptions

Class ImageOrPrintOptions

Tên không gian: Aspose.Cells.Rendering Tổng hợp: Aspose.Cells.dll (25.4.0)

Cho phép xác định các tùy chọn khi trình bày bảng tính cho hình ảnh, in bảng tính hoặc trình bày biểu đồ cho hình ảnh.

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()

Ctô

public ImageOrPrintOptions()

Properties

AllColumnsInOnePagePerSheet

Nếu AllColumnsInOnePagePerSheet là đúng , tất cả nội dung cột của một lá sẽ xuất phát đến chỉ một trang trong kết quả.Kích thước giấy của pageetup sẽ không có hiệu lực, và các cài đặt khác của pageetupsẽ vẫn có hiệu lực.

public bool AllColumnsInOnePagePerSheet { get; set; }

Giá trị bất động sản

bool

ChartImageType

Chỉ định hình ảnh biểu đồ khi chuyển đổi.Giá trị mặc định: 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; }

Giá trị bất động sản

ImageFormat

Remarks

Lưu ý: Thành viên này bây giờ đã quá cũ. thay vào đó,Các biểu đồ và hình dạng luôn được trình bày như các yếu tố vector (ví dụ: điểm, dòng) để render chất lượng.Tài sản này sẽ bị loại bỏ 12 tháng sau đó kể từ tháng 6 năm 2022.Aspose xin lỗi vì bất kỳ khó chịu nào bạn có thể đã trải qua.

CheckWorkbookDefaultFont

Khi các ký tự trong Excel là Unicode và không được thiết lập với phông chữ đúng trong phong cách ô,Họ có thể xuất hiện như một khối trong pdf, hình ảnh.Đặt điều này đúng để cố gắng sử dụng phông chữ mặc định của sổ làm việc để hiển thị các ký tự này đầu tiên.

public bool CheckWorkbookDefaultFont { get; set; }

Giá trị bất động sản

bool

Remarks

Default là đúng.

CustomPrintPageEventHandler

Khách hàng có thể xuất đặc biệt để in khi in mỗi trang bằng cách sử dụng EventHandler này

public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }

Giá trị bất động sản

PrintPageEventHandler

CustomQueryPageSettingsEventHandler

Khách hàng có thể kiểm soát cài đặt trang của máy in khi in mỗi trang bằng cách sử dụng EventHandler này

public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }

Giá trị bất động sản

QueryPageSettingsEventHandler

DefaultEditLanguage

Nhận hoặc đặt ngôn ngữ chỉnh sửa mặc định.

public DefaultEditLanguage DefaultEditLanguage { get; set; }

Giá trị bất động sản

DefaultEditLanguage

Remarks

Nó có thể hiển thị / chuyển giao bố trí khác nhau cho đoạn văn khi các ngôn ngữ chỉnh sửa khác nhau được thiết lập.Theo mặc định là Aspose.Cells.DefaultEditLanguage.Auto.

DefaultFont

Khi các ký tự trong Excel là Unicode và không được thiết lập với phông chữ đúng trong phong cách ô,Họ có thể xuất hiện như một khối trong pdf, hình ảnh.Thiết lập DefaultFont như MingLiu hoặc MS Gothic để hiển thị các nhân vật này.Nếu thuộc tính này không được thiết lập, Aspose.Cells sẽ sử dụng phông chữ mặc định của hệ thống để hiển thị các ký tự unicode này.

public string DefaultFont { get; set; }

Giá trị bất động sản

string

DrawObjectEventHandler

Thực hiện giao diện này để có được DrawObject và Bound khi rendering.

public DrawObjectEventHandler DrawObjectEventHandler { get; set; }

Giá trị bất động sản

DrawObjectEventHandler

EmbededImageNameInSvg

Nhập tên file của hình ảnh nhúng trong svg.Đây phải là con đường đầy đủ với thư mục như “c:\xpsEmbedded”

[Obsolete("Images are always embedded in Svg with base64 format, please remove this property.")]
[Browsable(false)]
public string EmbededImageNameInSvg { get; set; }

Giá trị bất động sản

string

EmfRenderSetting

Cài đặt để rendering Emf metaphiles trong file nguồn.

public EmfRenderSetting EmfRenderSetting { get; set; }

Giá trị bất động sản

EmfRenderSetting

Remarks

Các mã hóa EMF được xác định là “EMF+ Dual” có thể chứa cả hồ sơ EMF+ và hồ sơ EMF.Có thể sử dụng bất kỳ loại bản ghi nào để trình bày hình ảnh, chỉ có bản ghi EMF+ hoặc chỉ có bản ghi EMF.Khi Aspose.Cells.EmfRenderSetting.EmfPlusPrefer được thiết lập, sau đó các bản ghi EMF+ sẽ được parsed trong khi trình bày cho hình ảnh, nếu không chỉ các bản ghi EMF sẽ được parsed.Giá trị mặc định là Aspose.Cells.EmfRenderSetting.EmfOnly.Đối với các khung phụ thuộc vào .Net System.Drawing.Common, thiết lập này bị bỏ qua.

EmfType

Nhận hoặc đặt một EmfType mà chỉ định định dạng của Metafile..Giá trị mặc định là EmfPlusDual.

public EmfType EmfType { get; set; }

Giá trị bất động sản

EmfType

GridlineType

Gets hoặc set gridline type.

public GridlineType GridlineType { get; set; }

Giá trị bất động sản

GridlineType

Remarks

Nhược điểm là Dotted Type.

HorizontalResolution

Nhận hoặc đặt độ phân giải ngang cho hình ảnh được tạo ra, trong điểm mỗi inch.

public int HorizontalResolution { get; set; }

Giá trị bất động sản

int

Examples

Mã sau đây đặt độ phân giải lên 192, chiều rộng và chiều cao của hình ảnh được tạo ra là gấp đôimột với độ phân giải còn lại là giá trị mặc định 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

Giá trị mặc định là 96.

Thiết lập Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution và Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution ảnh hưởng đến chiều rộng và chiều cao của hình ảnh output trong pixel.

ImageType

Nhận hoặc đặt định dạng của hình ảnh được tạo ra.Giá trị mặc định: PNG

public virtual ImageType ImageType { get; set; }

Giá trị bất động sản

ImageType

IsCellAutoFit

Nó chỉ ra nếu chiều rộng và chiều cao của các tế bào được tự động tùy chỉnh theo giá trị ô.Giá trị mặc định là giả.

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

Giá trị bất động sản

bool

Remarks

Lưu ý: Thành viên này bây giờ đã quá cũ. thay vào đó,Vui lòng sử dụng Aspose.Cells.Worksheet.AutoFitColumns(_W L 27.AutofitterOptions) và __ WL 27 _.Tài sản này sẽ bị loại bỏ 12 tháng sau đó kể từ tháng 8 năm 2022.Aspose xin lỗi vì bất kỳ khó chịu nào bạn có thể đã trải qua.

IsFontSubstitutionCharGranularity

Nó chỉ ra liệu bạn chỉ nên thay thế chữ ký nhân vật khi chữ ký ô không tương thích với nó.

public bool IsFontSubstitutionCharGranularity { get; set; }

Giá trị bất động sản

bool

Remarks

Chúng tôi sẽ thử phông chữ mặc định của Workbook và PdfSaveOption/system cho phông chữ cell đầu tiên.

IsOptimized

Nó chỉ ra liệu để tối ưu hóa các yếu tố sản xuất.

public bool IsOptimized { get; set; }

Giá trị bất động sản

bool

Remarks

Giá trị mặc định là giả.Hiện tại, khi tài sản này được thiết lập thực tế, các tối ưu hóa sau đây sẽ được thực hiện:

  • Tối ưu hóa các đường biên giới
  • Tối ưu hóa kích thước tệp trong khi rendering đến hình ảnh Svg.

OnePagePerSheet

Nếu OnePagePerSheet là đúng , tất cả nội dung của một trang sẽ xuất phát đến chỉ một trang trong kết quả.Kích thước giấy của pageetup sẽ không có hiệu lực, và các cài đặt khác của pageetupsẽ vẫn có hiệu lực.

public bool OnePagePerSheet { get; set; }

Giá trị bất động sản

bool

OnlyArea

Nếu tài sản này là đúng , một Khu vực sẽ là sản xuất, và không có quy mô sẽ có hiệu lực.

public bool OnlyArea { get; set; }

Giá trị bất động sản

bool

OutputBlankPageWhenNothingToPrint

Nó chỉ ra liệu bạn nên xuất một trang trống khi không có gì để in.

public bool OutputBlankPageWhenNothingToPrint { get; set; }

Giá trị bất động sản

bool

Remarks

Default là giả.

PageCount

Nhận hoặc đặt số lượng trang để lưu.

public int PageCount { get; set; }

Giá trị bất động sản

int

Remarks

Theo mặc định là System.Int32.MaxValue có nghĩa là tất cả các trang sẽ được trình bày.

PageIndex

Nhận hoặc đặt chỉ số dựa trên 0 của trang đầu tiên để lưu.

public int PageIndex { get; set; }

Giá trị bất động sản

int

Remarks

Mức tiêu chuẩn là 0.

PageSavingCallback

Kiểm soát / chỉ thị tiến bộ của quá trình lưu trữ trang.

public IPageSavingCallback PageSavingCallback { get; set; }

Giá trị bất động sản

IPageSavingCallback

PixelFormat

Nhận hoặc đặt định dạng pixel cho hình ảnh được tạo ra.

public PixelFormat PixelFormat { get; set; }

Giá trị bất động sản

PixelFormat

Remarks

Giá trị mặc định là PixelFormat.Format32bppArgb.

PrintWithStatusDialog

Nếu PrintWithStatusDialog = true , sẽ có một cuộc đối thoại hiển thị trạng thái in hiện tại.Nếu không, sẽ không có cuộc đối thoại như vậy.

public bool PrintWithStatusDialog { get; set; }

Giá trị bất động sản

bool

PrintingPage

Chỉ định các trang nào sẽ không được in.

public PrintingPageType PrintingPage { get; set; }

Giá trị bất động sản

PrintingPageType

Quality

Nhận hoặc đặt một giá trị xác định chất lượng của imagesto được tạo chỉ áp dụng khi lưu các trang vào định dạng ‘Jpeg’.

public int Quality { get; set; }

Giá trị bất động sản

int

Remarks

Chỉ có hiệu quả khi tiết kiệm đến JPEG.Giá trị phải giữa 0 và 100.Giá trị mặc định là 100.

Đánh giá SVGFitToViewPort

Nếu tài sản này là đúng, SVG được tạo sẽ phù hợp để xem cảng.

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

Giá trị bất động sản

bool

SaveFormat

Nhận hoặc đặt kiểu định dạng tệp outputHỗ trợ Tiff/XPS

[Obsolete("For Tiff/Svg, use ImageType; For Xps, use Workbook.Save(string, SaveOptions) with XpsSaveOptions")]
[Browsable(false)]
public SaveFormat SaveFormat { get; set; }

Giá trị bất động sản

SaveFormat

Remarks

Lưu ý: Thành viên này bây giờ đã quá cũ. thay vào đó,Đối với Tiff/Svg, hãy sử dụng Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType; đối với Xps, dùng __ WL27.Workbook.Save(System.String,_Wl27.saveoptions) với __VL37.XpsSavOption.Tài sản này sẽ bị loại bỏ 12 tháng sau đó kể từ tháng 8 năm 2022.Aspose xin lỗi vì bất kỳ khó chịu nào bạn có thể đã trải qua.

SheetSet

Theo mặc định là tất cả các lá có thể nhìn thấy trong sổ làm việc: Aspose.Cells.Rendering.SheetSet.Visible.

public SheetSet SheetSet { get; set; }

Giá trị bất động sản

SheetSet

Remarks

Bộ được bỏ qua khi nó được sử dụng trong Aspose.Cells.Rendering.SheetRender

SmoothingMode

Nên xác định xem liệu độ ẩm (antialiasing) được áp dụng cho các dòng và curves và các cạnh của các khu vực đầy.Giá trị mặc định là SmoothingMode.None

public SmoothingMode SmoothingMode { get; set; }

Giá trị bất động sản

SmoothingMode

SvgCssPrefix

Nhận và đặt tiền tệ của tên css trong svg, giá trị mặc định là dòng trống.

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

Giá trị bất động sản

string

TextCrossType

Nhận hoặc đặt hiển thị kiểu văn bản khi chiều rộng văn bản lớn hơn chiều rộng ô.

public TextCrossType TextCrossType { get; set; }

Giá trị bất động sản

TextCrossType

TextRenderingHint

Định nghĩa chất lượng của rendering văn bản.Giá trị mặc định là TextRenderingHint.SystemDefault

public TextRenderingHint TextRenderingHint { get; set; }

Giá trị bất động sản

TextRenderingHint

TiffBinarizationMethod

Nhận hoặc thiết lập phương pháp được sử dụng trong khi chuyển đổi hình ảnh sang định dạng 1 bppkhi Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType là Tiff và Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompression là tương đương với Ccitt3 hoặc Ccitt4.

public ImageBinarizationMethod TiffBinarizationMethod { get; set; }

Giá trị bất động sản

ImageBinarizationMethod

Remarks

Giá trị mặc định là FloydSteinbergDithering.

TiffColorDepth

Nhận hoặc đặt độ sâu bit để áp dụng chỉ khi lưu các trang vào định dạng ‘Tiff’.

public ColorDepth TiffColorDepth { get; set; }

Giá trị bất động sản

ColorDepth

Remarks

Chỉ có hiệu quả khi tiết kiệm cho TIFF.Nếu TiffCompression được thiết lập cho CCITT3, CCITT4, điều này sẽ không có hiệu lực, độ sâu bit của hình ảnh tiff được tạo ra sẽ luôn là 1.

TiffCompression

Nhận hoặc đặt loại nén để áp dụng chỉ khi lưu các trang trong định dạng ‘Tiff’.

public TiffCompression TiffCompression { get; set; }

Giá trị bất động sản

TiffCompression

Remarks

Chỉ có hiệu quả khi tiết kiệm cho TIFF.Giá trị mặc định là Lzw.

Transparent

Nó chỉ ra liệu nền của hình ảnh được tạo nên có phải là minh bạch hay không.

public bool Transparent { get; set; }

Giá trị bất động sản

bool

Remarks

Giá trị mặc định là giả, có nghĩa là nền hình ảnh được tạo ra là màu trắng.

VerticalResolution

Nhận hoặc đặt độ phân giải dọc cho hình ảnh được tạo ra, trong điểm mỗi inch.

public int VerticalResolution { get; set; }

Giá trị bất động sản

int

Examples

Mã sau đây đặt độ phân giải lên 192, chiều rộng và chiều cao của hình ảnh được tạo ra là gấp đôimột với độ phân giải còn lại là giá trị mặc định 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

Giá trị mặc định là 96.

Thiết lập Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution và Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution ảnh hưởng đến chiều rộng và chiều cao của hình ảnh output trong pixel.

WarningCallback

Nhận hoặc đặt cảnh báo callback.

public IWarningCallback WarningCallback { get; set; }

Giá trị bất động sản

IWarningCallback

Methods

SetDesiredSize(int, int)

Thiết lập chiều rộng và chiều cao của hình ảnh mong muốn.

[Obsolete("Use SetDesiredSize(int, int, bool) by setting param keepAspectRatio to false instead.")]
public void SetDesiredSize(int desiredWidth, int desiredHeight)

Parameters

desiredWidth int

Tần rộng mong muốn trong pixels

desiredHeight int

Độ cao mong muốn trong pixels

Remarks

Lưu ý: Thành viên này bây giờ đã quá cũ. thay vào đó,Vui lòng sử dụng Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) bằng cách thiết lập param keepAspectRatio to false.Bất động sản này sẽ bị loại bỏ 12 tháng sau đó kể từ tháng 5 năm 2023.Aspose xin lỗi vì bất kỳ khó chịu nào bạn có thể đã trải qua.

SetDesiredSize(int, int và bool)

Thiết lập chiều rộng và chiều cao của hình ảnh mong muốn.

public void SetDesiredSize(int desiredWidth, int desiredHeight, bool keepAspectRatio)

Parameters

desiredWidth int

Tần rộng mong muốn trong pixels

desiredHeight int

Độ cao mong muốn trong pixels

keepAspectRatio bool

Để duy trì tỷ lệ khía cạnh của hình ảnh nguồn

Remarks

Chiều rộng và chiều cao của hình ảnh phát ra trong pixel sẽ chỉ dựa trên độ rộng và chiều cao mong muốn.

Các Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution và Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution sẽ không ảnh hưởng đến chiều rộng và chiều cao của hình ảnh xuất trong trường hợp này.

 Tiếng Việt