Class ImageOrPrintOptions

Class ImageOrPrintOptions

ชื่อพื้นที่: Aspose.Cells.Rendering การประกอบ: Aspose.Cells.dll (25.4.0)

อนุญาตให้ระบุตัวเลือกเมื่อ rendering แผ่นงานไปยังภาพพิมพ์ แผ่นงานหรือ rendering แผ่นงานไปยังภาพ

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 เป็นจริงทั้งหมดเนื้อหาคอลัมน์ของแผ่นเดียวจะส่งออกไปยังหน้าเดียวในผลความกว้างของขนาดกระดาษของ Pageetup จะไม่ถูกต้องและตั้งค่าอื่น ๆ ของ Pageetupจะยังคงมีผล

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 (เช่นจุดเส้น) เพื่อให้ส่งมอบคุณภาพคุณสมบัตินี้จะถูกยกเลิก 12 เดือนหลังจากเดือนมิถุนายน 2022.Aspose ขออภัยสําหรับปัญหาใด ๆ ที่คุณอาจมีประสบการณ์

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 จะใช้ตัวอักษรเริ่มต้นของระบบเพื่อแสดงตัวอักษร unicode นี้

public string DefaultFont { get; set; }

คุณสมบัติมูลค่า

string

DrawObjectEventHandler

ใช้อินเตอร์เฟซนี้เพื่อรับ DrawObject และ Bound เมื่อ rendering

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+ Dual” สามารถรวมทั้งบันทึก EMF+ และบันทึก EMFไม่ว่าประเภทของบันทึกสามารถใช้ในการแสดงภาพเพียงบันทึก EMF+ หรือบันทึก EMF เท่านั้นเมื่อการตั้งค่า Aspose.Cells.EmfRenderSetting.EmfPlusPrefer จากนั้นบันทึก EMF+ จะถูก parsed ในขณะที่แสดงให้เห็นภาพในทางตรงกันข้ามบันทึก EMFเท่านั้นจะ parsedค่าเริ่มต้นคือ Aspose.Cells.EmfRenderSetting.EmfOnlyสําหรับกรอบที่ขึ้นอยู่กับ .Net System.Drawing.Common การตั้งค่านี้จะถูก ignored

EmfType

รับหรือตั้งค่า EmfType ซึ่งระบุรูปแบบของ Metafileค่าเริ่มต้นคือ EmfPlusDual

public EmfType EmfType { get; set; }

คุณสมบัติมูลค่า

EmfType

GridlineType

รับหรือตั้งค่าประเภท gridline

public GridlineType GridlineType { get; set; }

คุณสมบัติมูลค่า

GridlineType

Remarks

ประเภทที่กําหนดเอง

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 .AutofitRows(____W W L 28 _ .Autophitteroptions).คุณสมบัตินี้จะถูกยกเลิก 12 เดือนหลังจากเดือนพฤษภาคม 2022.Aspose ขออภัยสําหรับปัญหาใด ๆ ที่คุณอาจมีประสบการณ์

IsFontSubstitutionCharGranularity

แสดงให้เห็นว่าจะเปลี่ยนตัวอักษรเฉพาะเมื่อตัวอักษรเซลล์ไม่เข้ากันได้กับมัน

public bool IsFontSubstitutionCharGranularity { get; set; }

คุณสมบัติมูลค่า

bool

Remarks

ปล่อยเป็นความผิดพลาด เราจะลองตัวอักษรเริ่มต้นของ Workbook และ PdfSaveOption/system สําหรับตัวอักษรเซลล์แรก

IsOptimized

แสดงให้เห็นว่าจะเพิ่มประสิทธิภาพขององค์ประกอบการผลิต

public bool IsOptimized { get; set; }

คุณสมบัติมูลค่า

bool

Remarks

หมายเลขที่กําหนดเองคือข้อผิดพลาดในขณะนี้เมื่อคุณสมบัตินี้ได้รับการตั้งค่าเป็นจริงแล้วการปรับปรุงต่อไปนี้จะดําเนินการ:

  • ปรับปรุงเส้นขอบเขต
  • ปรับปรุงขนาดไฟล์ในขณะที่แสดงให้เห็นภาพ Svg

OnePagePerSheet

หาก OnePagePerSheet เป็นจริงแล้วเนื้อหาทั้งหมดของแผ่นเดียวจะส่งออกไปยังหน้าเดียวเท่านั้นขนาดกระดาษของ pagesetup จะไม่ถูกต้องและตั้งค่าอื่น ๆ ของ pagesetupจะยังคงมีผล

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 = จริง จะมีปฏิทินที่แสดงสถานะการพิมพ์ปัจจุบันถ้าไม่มีการปฏิทินดังกล่าวจะแสดงให้เห็น

public bool PrintWithStatusDialog { get; set; }

คุณสมบัติมูลค่า

bool

PrintingPage

แสดงให้เห็นว่าหน้าใดจะไม่ถูกพิมพ์

public PrintingPageType PrintingPage { get; set; }

คุณสมบัติมูลค่า

PrintingPageType

Quality

รับหรือตั้งค่าค่าที่กําหนดคุณภาพของ imagesto ที่สร้างใช้เฉพาะเมื่อบันทึกหน้าในรูปแบบ ‘Jpeg’ หมายเลขค่าเริ่มต้นคือ 100

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 _ SaveOption) กับ _www.wl27.คุณสมบัตินี้จะถูกยกเลิก 12 เดือนหลังจากเดือนพฤษภาคม 2022.Aspose ขออภัยสําหรับปัญหาใด ๆ ที่คุณอาจมีประสบการณ์

SheetSet

รับหรือตั้งค่าแผ่นเพื่อให้ได้ ตัวเลือกคือแผ่นที่มองเห็นทั้งหมดในสมุดงาน: Aspose.Cells.Rendering.SheetSet.Visible

public SheetSet SheetSet { get; set; }

คุณสมบัติมูลค่า

SheetSet

Remarks

ชุดจะถูก ignored เมื่อใช้ใน Aspose.Cells.Rendering.SheetRender

SmoothingMode

รายละเอียดว่าการระบายความร้อน (ป้องกันการระบายความร้อน) จะถูกนําไปใช้กับเส้นและโค้งและขอบของพื้นที่ที่เต็มไปด้วยค่าเริ่มต้นคือ SmoothingMode.None

public SmoothingMode SmoothingMode { get; set; }

คุณสมบัติมูลค่า

SmoothingMode

SvgCssPrefix

รับและตั้งค่าค่าเริ่มต้นของชื่อ css ใน svg,ค่าเริ่มต้นคือเส้นที่ว่างเปล่า

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

คุณสมบัติมูลค่า

string

TextCrossType

รับหรือตั้งค่าการแสดงประเภทข้อความเมื่อความกว้างข้อความขนาดใหญ่กว่าความกว้างเซลล์

public TextCrossType TextCrossType { get; set; }

คุณสมบัติมูลค่า

TextCrossType

TextRenderingHint

รายละเอียดคุณภาพของข้อความ renderingค่าเริ่มต้นคือ 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

รับหรือตั้งค่าการแจ้งเตือน callback

public IWarningCallback WarningCallback { get; set; }

คุณสมบัติมูลค่า

IWarningCallback

Methods

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

ความกว้างที่ต้องการใน pixels

desiredHeight int

ความสูงที่ต้องการใน pixels

Remarks

หมายเหตุ: อนุมัตินี้ตอนนี้เป็นอิสระแทนที่โปรดใช้ Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) โดยการตั้งค่า param keepAspectRatio to falseคุณสมบัตินี้จะถูกยกเลิก 12 เดือนหลังจากเดือนเมษายน 2023Aspose ขออภัยสําหรับปัญหาใด ๆ ที่คุณอาจมีประสบการณ์

SetDesiredSize(int, int, bool)

กําหนดความกว้างและความสูงของภาพที่ต้องการ

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

Parameters

desiredWidth int

ความกว้างที่ต้องการใน pixels

desiredHeight int

ความสูงที่ต้องการใน pixels

keepAspectRatio bool

หากคุณต้องการรักษาความสัมพันธ์ของรูปร่างของภาพกําเนิด

Remarks

ความกว้างและความสูงของภาพออกในพิกเซลจะขึ้นอยู่กับความกว้างและความสูงที่ต้องการ

Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution และ Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution จะไม่ส่งผลกระทบต่อความกว้างและความสูงของภาพออกในกรณีนี้

 แบบไทย