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
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
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
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
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
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
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
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
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
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
EmfRenderSetting
Cài đặt để rendering Emf metaphiles trong file nguồn.
public EmfRenderSetting EmfRenderSetting { get; set; }
Giá trị bất động sản
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..
public EmfType EmfType { get; set; }
Giá trị bất động sản
GridlineType
Gets hoặc set gridline type.
public GridlineType GridlineType { get; set; }
Giá trị bất động sản
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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.