Class ImageOrPrintOptions
Numele spaţiului: Aspose.Cells.Rendering Asamblare: Aspose.Cells.dll (25.4.0)
Permiteți să specificați opțiuni atunci când renderizați hârtia de lucru la imagini, tipăriți hârtia de lucru sau renderizați graficul la imagine.
public class ImageOrPrintOptionsInheritance
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()
în Ctor.
public ImageOrPrintOptions()Properties
AllColumnsInOnePagePerSheet
Dacă AllColumnsInOnePagePerSheet este adevărat, conținutul tuturor coloanelor dintr-o singură pagină va ieși la o singură pagină ca rezultat.Amploarea dimensiunii hârtiei paginii va fi invalidă, iar celelalte setări paginiiVa mai avea efect.
public bool AllColumnsInOnePagePerSheet { get; set; }Valoarea proprietății
ChartImageType
Indicați tipul de imagine al diagramei la conversie.Valoarea standardă: 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; }Valoarea proprietății
Remarks
NOTĂ: Acest membru este acum obositor. în schimb,Graficul și forma sunt întotdeauna renderate ca elemente vectoriale (de exemplu, punct, linie) pentru renderarea calității.Această proprietate va fi îndepărtată 12 luni mai târziu de la iunie 2022.Aspose se scuze pentru orice inconveniente pe care le-ați simțit.
CheckWorkbookDefaultFont
Când caracterele din Excel sunt Unicode și nu sunt setate cu fontul corect în stilul celulei,Acestea pot apărea ca blocuri în pdf, imagine.Faceți acest lucru adevărat pentru a încerca să utilizați fontul predefinit al cărții de lucru pentru a afișa mai întâi aceste caractere.
public bool CheckWorkbookDefaultFont { get; set; }Valoarea proprietății
Remarks
Defectul este adevărat.
CustomPrintPageEventHandler
Clientul poate obține o ieșire specială pentru imprimare atunci când imprimă fiecare pagină folosind acest EventHandler
public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }Valoarea proprietății
CustomQueryPageSettingsEventHandler
Clientul poate controla setarea paginii printerului atunci cand imprima fiecare pagina folosind acest EventHandler
public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }Valoarea proprietății
DefaultEditLanguage
Obține sau stabilește limba de edit default.
public DefaultEditLanguage DefaultEditLanguage { get; set; }Valoarea proprietății
Remarks
Acesta poate afișa/render layout-uri diferite pentru paragraful text atunci când sunt setate diferite limbi de editare.Default este Aspose.Cells.DefaultEditLanguage.Auto.
DefaultFont
Când caracterele din Excel sunt Unicode și nu sunt setate cu fontul corect în stilul celulei,Acestea pot apărea ca blocuri în pdf, imagine.Setarea DefaultFont, cum ar fi MingLiu sau MS Gothic, pentru a afișa aceste caractere.Dacă această proprietate nu este setată, Aspose.Cells va folosi fontul de bază al sistemului pentru a afișa aceste caractere unicode.
public string DefaultFont { get; set; }Valoarea proprietății
DrawObjectEventHandler
Aplicați această interfață pentru a obține DrawObject și Bound atunci când rendering.
public DrawObjectEventHandler DrawObjectEventHandler { get; set; }Valoarea proprietății
EmbededImageNameInSvg
Indicați numele de fișier al imaginii încorporate în svg.Aceasta ar trebui să fie o cale completă cu directorii cum ar fi “c:\xpsEmbedded”
[Obsolete("Images are always embedded in Svg with base64 format, please remove this property.")]
[Browsable(false)]
public string EmbededImageNameInSvg { get; set; }Valoarea proprietății
EmfRenderSetting
Setări pentru renderarea metafizelor EMF în fișierul de sursă.
public EmfRenderSetting EmfRenderSetting { get; set; }Valoarea proprietății
Remarks
Metafilele EMF identificate ca „EMF+ Dual” pot conține atât înregistrările EMF+ cât și înregistrările EMF.Orice tip de înregistrare poate fi utilizat pentru a face imaginea, numai înregistrările EMF+ sau numai înregistrările EMF.Atunci când este setat Aspose.Cells.EmfRenderSetting.EmfPlusPrefer, atunci înregistrările EMF+ vor fi parse în timp ce se renderă imaginii, altfel numai înregistrările EMF vor fi parse.Valoarea de bază este Aspose.Cells.EmfRenderSetting.EmfOnly.Pentru cadrele care depind de .Net System.Drawing.Common, această setare este ignorată.
EmfType
Obține sau stabilește un EmfType care specifică formatul Metafile.
public EmfType EmfType { get; set; }Valoarea proprietății
GridlineType
Obține sau stabilește tipul de gridline.
public GridlineType GridlineType { get; set; }Valoarea proprietății
Remarks
Deficitul este tipul Dotted.
HorizontalResolution
Obține sau stabilește rezoluția orizontală pentru imaginile generate, în puncte pe inch.
public int HorizontalResolution { get; set; }Valoarea proprietății
Examples
Codul următor stabilește rezoluția la 192, lățimea și înălțimea imaginii generate sunt de două ori mai mari decâtUnul cu rezoluție a rămas ca valoarea standard 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
Valoarea defectuoasă este 96.
Setarea Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution și Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution afectează lățimea și înălțimea imaginii de ieșire în pixeli.
ImageType
Obține sau stabilește formatul imaginilor generate.Valoarea standardă: PNG
public virtual ImageType ImageType { get; set; }Valoarea proprietății
IsCellAutoFit
Indică dacă amploarea și înălțimea celulelor sunt ajustate automat de valoarea celulei.Valoarea defectuoasă este falsă.
[Obsolete("Use Worksheet.AutoFitColumns(AutoFitterOptions) and Worksheet.AutoFitRows(AutoFitterOptions) instead.")]
[Browsable(false)]
public bool IsCellAutoFit { get; set; }Valoarea proprietății
Remarks
NOTĂ: Acest membru este acum obositor. în schimb,Vă rugăm să folosiți Aspose.Cells.Worksheet.AutoFitColumns(_W L 27.AutofitterOptions) și __ WL 27 _.Traduceri.Această proprietate va fi îndepărtată 12 luni mai târziu de la august 2022.Aspose se scuze pentru orice inconveniente pe care le-ați simțit.
IsFontSubstitutionCharGranularity
Indică dacă să înlocuiască doar fontul de caracter atunci când fontul celulelor nu este compatibil cu acesta.
public bool IsFontSubstitutionCharGranularity { get; set; }Valoarea proprietății
Remarks
Vom încerca mai întâi fontul predefinit de Workbook și PdfSaveOption/system pentru fontul celular.
IsOptimized
Indică dacă să optimizeze elementele de producție.
public bool IsOptimized { get; set; }Valoarea proprietății
Remarks
Valoarea defectuoasă este falsă.În prezent, atunci când această proprietate este stabilită, vor fi efectuate următoarele optimizări:
- optimizarea liniilor de frontieră.
- optimizează dimensiunea fișierului în timp ce renderă imaginea Svg.
OnePagePerSheet
Dacă OnePagePerSheet este adevărat, toate conținuturile dintr-o singură pagină vor ieși la o singură pagină ca rezultat.Dimensiunea de hârtie a paginii va fi invalidă, iar celelalte setări ale paginiiVa mai avea efect.
public bool OnePagePerSheet { get; set; }Valoarea proprietății
OnlyArea
Dacă această proprietate este adevărată, o zonă va fi o producție și nici o scară nu va intra în vigoare.
public bool OnlyArea { get; set; }Valoarea proprietății
OutputBlankPageWhenNothingToPrint
Indică dacă să emite o pagină albă atunci când nu există nimic de imprimat.
public bool OutputBlankPageWhenNothingToPrint { get; set; }Valoarea proprietății
Remarks
Defectul este fals.
PageCount
Obține sau stabilește numărul de pagini pentru a salva.
public int PageCount { get; set; }Valoarea proprietății
Remarks
Default este System.Int32.MaxValue ceea ce înseamnă că toate paginile vor fi renderate.
PageIndex
Obține sau stabilește indexul bazat pe 0 al primei pagini pentru a salva.
public int PageIndex { get; set; }Valoarea proprietății
Remarks
Defectul este 0.
PageSavingCallback
Control / Indică progresul procesului de salvare a paginii.
public IPageSavingCallback PageSavingCallback { get; set; }Valoarea proprietății
PixelFormat
Obține sau stabilește formatul pixel pentru imaginile generate.
public PixelFormat PixelFormat { get; set; }Valoarea proprietății
Remarks
Valoarea standardă este PixelFormat.Format32bppArgb.
PrintWithStatusDialog
Dacă PrintWithStatusDialog = adevărat, va exista un dialog care va arăta starea de imprimare curentă.În caz contrar, niciun astfel de dialog nu va fi prezentat.
public bool PrintWithStatusDialog { get; set; }Valoarea proprietății
PrintingPage
Indică care pagini nu vor fi imprimate.
public PrintingPageType PrintingPage { get; set; }Valoarea proprietății
Quality
Obține sau stabilește o valoare care determină calitatea imagestului generat se aplică numai atunci când se salvează paginile în format “Jpeg”.
public int Quality { get; set; }Valoarea proprietății
Remarks
Funcționează numai atunci când economisiți în JPEG.Valoarea trebuie să fie între 0 și 100.Valoarea standard este de 100.
Cuvânt cheie
Dacă această proprietate este adevărată, svg-ul generat va fi potrivit pentru a vizualiza portul.
[Obsolete("Use SvgImageOptions.FitToViewPort property instead.")]
[Browsable(false)]
public bool SVGFitToViewPort { get; set; }Valoarea proprietății
SaveFormat
Obține sau stabilește tipul de format de fișier de ieșireSuport pentru Tiff/XPS
[Obsolete("For Tiff/Svg, use ImageType; For Xps, use Workbook.Save(string, SaveOptions) with XpsSaveOptions")]
[Browsable(false)]
public SaveFormat SaveFormat { get; set; }Valoarea proprietății
Remarks
NOTĂ: Acest membru este acum obositor. în schimb,Pentru Tiff/Svg, utilizați Aspose.Cells.Rendering.ImageOrPrintOptions. ImageType; pentru Xps, folosiți W L27.Workbook.Save(System.String,Wl27__.Salvați Opțiuni) cu __ WL27.Această proprietate va fi îndepărtată 12 luni mai târziu de la august 2022.Aspose se scuze pentru orice inconveniente pe care le-ați simțit.
SheetSet
Default este toate frunzele vizibile din cartea de lucru: Aspose.Cells.Rendering.SheetSet.Visible.
public SheetSet SheetSet { get; set; }Valoarea proprietății
Remarks
Setul este ignorat atunci când este utilizat în Aspose.Cells.Rendering.SheetRender
SmoothingMode
Specifica dacă se aplică umezirea (antialiarea) la linii și curbe și la marginea zonelor umplute.Valoarea standard este SmoothingMode.None
public SmoothingMode SmoothingMode { get; set; }Valoarea proprietății
SvgCssPrefix
Obțineți și stabiliți prefixul numelui css în svg, valoarea predefinită este linie goală.
[Obsolete("Use SvgImageOptions.CssPrefix property instead.")]
[Browsable(false)]
public string SvgCssPrefix { get; set; }Valoarea proprietății
TextCrossType
Obține sau setă tipul de text atunci când lățimea textului este mai mare decât lățimea celulelor.
public TextCrossType TextCrossType { get; set; }Valoarea proprietății
TextRenderingHint
Specifica calitatea renderării textului.Valoarea standard este TextRenderingHint.SystemDefault
public TextRenderingHint TextRenderingHint { get; set; }Valoarea proprietății
TiffBinarizationMethod
Obține sau stabilește metoda utilizată în timp ce convertează imagini în format 1 bppatunci când Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType este Tiff și Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompression este egal cu Ccitt3 sau Ccitt4.
public ImageBinarizationMethod TiffBinarizationMethod { get; set; }Valoarea proprietății
Remarks
Valoarea standardă este FloydSteinbergDithering.
TiffColorDepth
Obține sau stabilește o adâncime de bit pentru a aplica numai atunci când salvați pagini în format ‘Tiff’.
public ColorDepth TiffColorDepth { get; set; }Valoarea proprietății
Remarks
Funcționează numai atunci când economisiți la TIFF.Dacă TiffCompression este setat la CCITT3, CCITT4, acest lucru nu va intra în vigoare, adâncimea picturii imaginii tiff generate va fi întotdeauna 1.
TiffCompression
Obține sau stabilește tipul de compresie care se aplică numai atunci când salvează paginile în format “Tiff”.
public TiffCompression TiffCompression { get; set; }Valoarea proprietății
Remarks
Funcționează numai atunci când economisiți la TIFF.Valoarea standardă este Lzw.
Transparent
Indică dacă fundalul imaginii generate ar trebui să fie transparent.
public bool Transparent { get; set; }Valoarea proprietății
Remarks
Valoarea predefinită este falsă, ceea ce înseamnă că fundalul imaginilor generate este alb.
VerticalResolution
Obține sau stabilește rezoluția verticală pentru imaginile generate, în puncte pe inch.
public int VerticalResolution { get; set; }Valoarea proprietății
Examples
Codul următor stabilește rezoluția la 192, lățimea și înălțimea imaginii generate sunt de două ori mai mari decâtUnul cu rezoluție a rămas ca valoarea standard 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
Valoarea defectuoasă este 96.
Setarea Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution și Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution afectează lățimea și înălțimea imaginii de ieșire în pixeli.
WarningCallback
Obține sau stabilește un avertisment callback.
public IWarningCallback WarningCallback { get; set; }Valoarea proprietății
Methods
SetDesiredSize(int, int)
Setă lățimea și înălțimea dorită a imaginii.
[Obsolete("Use SetDesiredSize(int, int, bool) by setting param keepAspectRatio to false instead.")]
public void SetDesiredSize(int desiredWidth, int desiredHeight)Parameters
desiredWidth int
Amploare dorită în pixeli
desiredHeight int
Înălțimea dorită în pixeli
Remarks
NOTĂ: Acest membru este acum obositor. în schimb,Vă rugăm să utilizați Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) prin setarea parametrului păstrândAspectRatio la fals.Această proprietate va fi îndepărtată 12 luni mai târziu de la mai 2023.Aspose se scuze pentru orice inconveniente pe care le-ați simțit.
SetDesiredSize(int, int, bool)
Setă lățimea și înălțimea dorită a imaginii.
public void SetDesiredSize(int desiredWidth, int desiredHeight, bool keepAspectRatio)Parameters
desiredWidth int
Amploare dorită în pixeli
desiredHeight int
Înălțimea dorită în pixeli
keepAspectRatio bool
să păstreze raportul aspect al imaginii de origine
Remarks
Amploarea și înălțimea imaginii de ieșire în pixeli vor fi bazate numai pe setul de lățime și înălțime dorită.
Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution și Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution nu va afecta lățimea și înălțimea imaginii de ieșire în acest caz.
