Class ImageOrPrintOptions

Pôvodný názov: Aspose.Cells.Rendering Zhromaždenie: Aspose.Cells.dll (25.4.0)

Umožňuje určiť možnosti pri renderovaní pracovnej dosky na obrázky, tlači pracovnú dosku alebo renderovaní grafu na obrázok.

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

a Ctor.

public ImageOrPrintOptions()

Properties

AllColumnsInOnePagePerSheet

Ak je AllColumnsInOnePagePerSheet pravdivý, celý obsah stĺpca jedného listu vyjde na iba jednu stránku v výsledku.Šírka veľkosti papiera stránky bude neplatná a ostatné nastavenia stránkyStále bude mať účinok.

public bool AllColumnsInOnePagePerSheet { get; set; }

Hodnota nehnuteľnosti

bool

ChartImageType

Ukazuje grafický typ obrazu pri konverzii.Predvolená hodnota: 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; }

Hodnota nehnuteľnosti

ImageFormat

Remarks

Poznámka: Tento člen je teraz zastaraný. namiesto toho,Charta a tvar sa vždy renderujú ako vektorové prvky (napr. bod, čiara) na renderovanie kvality.Táto nehnuteľnosť bude odstránená o 12 mesiacov neskôr od júna 2022.Aspose sa ospravedlňuje za akékoľvek nepríjemnosti, ktoré ste mohli zažiť.

CheckWorkbookDefaultFont

Ak sú znaky v programe Excel Unicode a nie sú nastavené s správnym písmom v štýle buniek,Môžu sa zobraziť ako blok v pdf, obrázok.Nastaviť to na pravdu, aby ste sa pokúsili použiť predvolené písmo v pracovnej knihe, aby ste najprv zobrazili tieto znaky.

public bool CheckWorkbookDefaultFont { get; set; }

Hodnota nehnuteľnosti

bool

Remarks

Default je pravda.

CustomPrintPageEventHandler

Zákazník môže špeciálny výstup na tlačiareň pri tlači každej stránky pomocou tohto EventHandler

public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }

Hodnota nehnuteľnosti

PrintPageEventHandler

CustomQueryPageSettingsEventHandler

Zákazník môže ovládať nastavenie stránky tlačiarne pri tlači každej stránky pomocou tohto EventHandler

public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }

Hodnota nehnuteľnosti

QueryPageSettingsEventHandler

DefaultEditLanguage

Získať alebo nastaviť predvolený edit jazyk.

public DefaultEditLanguage DefaultEditLanguage { get; set; }

Hodnota nehnuteľnosti

DefaultEditLanguage

Remarks

Môže zobraziť/predávať rôzne rozloženia pre textový odsek, keď sú nastavené rôzne jazyky úpravy.Predvolený je Aspose.Cells.DefaultEditLanguage.Auto.

DefaultFont

Ak sú znaky v programe Excel Unicode a nie sú nastavené s správnym písmom v štýle buniek,Môžu sa zobraziť ako blok v pdf, obrázok.Nastaviť DefaultFont ako MingLiu alebo MS Gothic zobrazovať tieto znaky.Ak táto vlastnosť nie je nastavená, Aspose.Cells bude používať systém predvolené písmo na zobrazenie týchto znakov unicode.

public string DefaultFont { get; set; }

Hodnota nehnuteľnosti

string

DrawObjectEventHandler

Implementuje tento rozhranie získať DrawObject a Bound pri renderovaní.

public DrawObjectEventHandler DrawObjectEventHandler { get; set; }

Hodnota nehnuteľnosti

DrawObjectEventHandler

EmbededImageNameInSvg

Zadajte názov vstavaného obrazu v svg.To by malo byť plná cesta s adresármi ako “c:\xpsEmbedded”

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

Hodnota nehnuteľnosti

string

EmfRenderSetting

Nastavenie renderovania metafyzík Emf v zdrojovom súbore.

public EmfRenderSetting EmfRenderSetting { get; set; }

Hodnota nehnuteľnosti

EmfRenderSetting

Remarks

Metafily EMF identifikované ako „EMF+ Dual“ môžu obsahovať aj záznamy EMF+ a záznamy EMF.Akýkoľvek typ záznamu môže byť použitý na odovzdanie obrazu, iba záznamy EMF+ alebo iba záznamy EMF.Keď je nastavený Aspose.Cells.EmfRenderSetting.EmfPlusPrefer, potom sa záznamy EMF+ prerušia pri odovzdávaní do obrazu, inak sa prerušia iba záznamy EMF.Predvolená hodnota je Aspose.Cells.EmfRenderSetting.EmfOnly.Pre rámy, ktoré závisia od .Net System.Drawing.Common, toto nastavenie je ignorované.

EmfType

Získať alebo nastaviť EmfType, ktorý špecifikuje formát Metafile..Predvolená hodnota je EmfPlusDual.

public EmfType EmfType { get; set; }

Hodnota nehnuteľnosti

EmfType

GridlineType

Získať alebo nastaviť typ gridline.

public GridlineType GridlineType { get; set; }

Hodnota nehnuteľnosti

GridlineType

Remarks

Default je Dotted typ.

HorizontalResolution

Získať alebo nastaviť horizontálnu rozlíšenie pre generované obrázky, v bodoch na palec.

public int HorizontalResolution { get; set; }

Hodnota nehnuteľnosti

int

Examples

Nasledujúci kód nastaví rozlíšenie na 192, šírka a výška generovaného obrazu je dvakrát vyššia akoTen s rozlíšením zostáva ako predvolená hodnota 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

Predvolená hodnota je 96.

Nastavenie Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution a Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution ovplyvňuje šírku a výšku výstupného obrazu v pixeloch.

ImageType

Získava alebo nastaví formát vytvorených obrázkov.Predvolená hodnota: PNG

public virtual ImageType ImageType { get; set; }

Hodnota nehnuteľnosti

ImageType

IsCellAutoFit

Ukazuje, či je šírka a výška buniek automaticky nastavená na hodnotu bunky.Predvolená hodnota je falošná.

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

Hodnota nehnuteľnosti

bool

Remarks

Poznámka: Tento člen je teraz zastaraný. namiesto toho,Prosím, použite Aspose.Cells.Worksheet.AutoFitColumns(_W L 27.AutofitterOptions) a __ WL 27 _.Tradbové listy.Táto nehnuteľnosť bude odstránená o 12 mesiacov neskôr od augusta 2022.Aspose sa ospravedlňuje za akékoľvek nepríjemnosti, ktoré ste mohli zažiť.

IsFontSubstitutionCharGranularity

Ukazuje, či nahradiť písmo charakteru len vtedy, keď nie je písmo buniek kompatibilné s ním.

public bool IsFontSubstitutionCharGranularity { get; set; }

Hodnota nehnuteľnosti

bool

Remarks

Predvolený je falošný. budeme sa pokúsiť predvolený font Workbook a PdfSaveOption/system pre cell font najprv.

IsOptimized

Ukazuje, či optimalizovať výstupné prvky.

public bool IsOptimized { get; set; }

Hodnota nehnuteľnosti

bool

Remarks

Defektná hodnota je falošná.V súčasnej dobe, keď je táto nehnuteľnosť nastavená na platnosť, budú vykonané nasledujúce optimalizácie:

Optimalizovať hranice.
optimalizovať veľkosť súboru pri renderovaní na Svg obrázok.

OnePagePerSheet

Ak je OnePagePerSheet pravdivý, celý obsah jedného listu vyjde na iba jednu stránku v výsledku.Veľkosť papiera na stránkach bude neplatná a ostatné nastavenia na stránkachStále bude mať účinok.

public bool OnePagePerSheet { get; set; }

Hodnota nehnuteľnosti

bool

OnlyArea

Ak je táto nehnuteľnosť pravdivá, jedna oblasť bude produkciou a žiadna škála nebude platná.

public bool OnlyArea { get; set; }

Hodnota nehnuteľnosti

bool

OutputBlankPageWhenNothingToPrint

Ukazuje, či vyhotoviť bielu stránku, keď nie je nič na tlač.

public bool OutputBlankPageWhenNothingToPrint { get; set; }

Hodnota nehnuteľnosti

bool

Remarks

Default je falošný.

PageCount

Získať alebo nastaviť počet stránok uložiť.

public int PageCount { get; set; }

Hodnota nehnuteľnosti

int

Remarks

V predvolenom nastavení je System.Int32.MaxValue, čo znamená, že všetky stránky budú renderované.

PageIndex

Získať alebo nastaviť index založený na 0 na prvej stránke uložiť.

public int PageIndex { get; set; }

Hodnota nehnuteľnosti

int

Remarks

Default je 0.

PageSavingCallback

Ovládanie / indikácia pokroku procesu ukladania stránok.

public IPageSavingCallback PageSavingCallback { get; set; }

Hodnota nehnuteľnosti

IPageSavingCallback

PixelFormat

Získať alebo nastaviť pixelový formát pre vytvorené obrázky.

public PixelFormat PixelFormat { get; set; }

Hodnota nehnuteľnosti

PixelFormat

Remarks

Predvolená hodnota je PixelFormat.Format32bppArgb.

PrintWithStatusDialog

Ak PrintWithStatusDialog = pravdivý , bude existovať dialóg, ktorý zobrazí aktuálny stav tlače.Inak sa takýto dialóg nevyskytne.

public bool PrintWithStatusDialog { get; set; }

Hodnota nehnuteľnosti

bool

PrintingPage

Ukazuje, ktoré stránky nebudú vytlačené.

public PrintingPageType PrintingPage { get; set; }

Hodnota nehnuteľnosti

PrintingPageType

Quality

Získať alebo nastaviť hodnotu, ktorá určuje kvalitu generovaného imagesto sa uplatňuje len vtedy, keď sa stránky uložia do formátu “Jpeg”.

public int Quality { get; set; }

Hodnota nehnuteľnosti

int

Remarks

Používa sa len pri úspore na JPEG.Hodnota musí byť medzi 0 a 100.Predvolená hodnota je 100.

SVGFitToViewPort

Ak je táto nehnuteľnosť pravdivá, generovaný svg sa hodí na zobrazenie prístavu.

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

Hodnota nehnuteľnosti

bool

SaveFormat

Získať alebo nastaviť typ formátu výstupného súboruPodpora Tiff/XPS

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

Hodnota nehnuteľnosti

SaveFormat

Remarks

Poznámka: Tento člen je teraz zastaraný. namiesto toho,Pre Tiff/Svg, použite Aspose.Cells.Rendering.ImageOrPrintOptions.ImažType; pre Xps, používať Wl27.Workbook.Save(System.String,W L 27 .Savoptions) s _ WL27.Táto nehnuteľnosť bude odstránená o 12 mesiacov neskôr od augusta 2022.Aspose sa ospravedlňuje za akékoľvek nepríjemnosti, ktoré ste mohli zažiť.

SheetSet

Predvolené sú všetky viditeľné listy v pracovnej knihe: Aspose.Cells.Rendering.SheetSet.Visible.

public SheetSet SheetSet { get; set; }

Hodnota nehnuteľnosti

SheetSet

Remarks

Súbor je ignorovaný, keď sa používa v Aspose.Cells.Rendering.SheetRender

SmoothingMode

Určuje, či sa na línie a krivky a okraje naplnených oblastí aplikuje hladkosť (antialiasing).Predvolená hodnota je SmoothingMode.None

public SmoothingMode SmoothingMode { get; set; }

Hodnota nehnuteľnosti

SmoothingMode

SvgCssPrefix

Dostane a nastaví predpísanie názvu css v svg,predvolená hodnota je prázdna riadok.

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

Hodnota nehnuteľnosti

string

TextCrossType

Dostane alebo nastaví zobrazenie typu textu, keď je šírka textu väčšia ako šírka bunky.

public TextCrossType TextCrossType { get; set; }

Hodnota nehnuteľnosti

TextCrossType

TextRenderingHint

Určuje kvalitu textového renderovania.Predvolená hodnota je TextRenderingHint.SystemDefault

public TextRenderingHint TextRenderingHint { get; set; }

Hodnota nehnuteľnosti

TextRenderingHint

TiffBinarizationMethod

Získajte alebo nastavíte metódu použitú pri konverzii obrázkov do formátu 1 bppkeď Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType je Tiff a Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompression je rovnaký ako Ccitt3 alebo Ccitt4.

public ImageBinarizationMethod TiffBinarizationMethod { get; set; }

Hodnota nehnuteľnosti

ImageBinarizationMethod

Remarks

Predvolená hodnota je FloydSteinbergDithering.

TiffColorDepth

Získajte alebo nastavíte bitovú hĺbku, ktorá sa aplikuje iba pri ukladaní stránok do formátu “Tiff”.

public ColorDepth TiffColorDepth { get; set; }

Hodnota nehnuteľnosti

ColorDepth

Remarks

Účinkuje len pri úspore na TIFF.Ak je nastavená aplikácia TiffCompression na CCITT3, CCITT4, nebude to fungovať, bitová hĺbka generovaného obrázka tiff bude vždy 1.

TiffCompression

Dostanete alebo nastavíte typ kompresie, ktorý sa použije len vtedy, keď sa stránky uložia do formátu “Tiff”.

public TiffCompression TiffCompression { get; set; }

Hodnota nehnuteľnosti

TiffCompression

Remarks

Účinkuje len pri úspore na TIFF.Predvolená hodnota je Lzw.

Transparent

Ukazuje, či pozadie generovaného obrazu by malo byť transparentné.

public bool Transparent { get; set; }

Hodnota nehnuteľnosti

bool

Remarks

Predvolená hodnota je falošná, čo znamená, že pozadie vytvorených obrázkov je biela.

VerticalResolution

Získať alebo nastaviť vertikálne rozlíšenie pre generované obrázky, v bodoch na palec.

public int VerticalResolution { get; set; }

Hodnota nehnuteľnosti

int

Examples

Nasledujúci kód nastaví rozlíšenie na 192, šírka a výška generovaného obrazu je dvakrát vyššia akoTen s rozlíšením zostáva ako predvolená hodnota 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

Predvolená hodnota je 96.

WarningCallback

Získajte alebo nastavíte upozornenie callback.

public IWarningCallback WarningCallback { get; set; }

Hodnota nehnuteľnosti

IWarningCallback

Methods

SetDesiredSize(a int, int)

Zadajte požadovanú šírku a výšku obrazu.

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

Parameters

desiredWidth int

požadovaná šírka v pixeloch

desiredHeight int

požadovaná výška v pixeloch

Remarks

Poznámka: Tento člen je teraz zastaraný. namiesto toho,Prosím, použite Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) nastavením parametu udržaťAspectRatio na falošné.Táto nehnuteľnosť bude odstránená o 12 mesiacov neskôr od mája 2023.Aspose sa ospravedlňuje za akékoľvek nepríjemnosti, ktoré ste mohli zažiť.

SetDesiredSize(int, int, bool)

Zadajte požadovanú šírku a výšku obrazu.

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

Parameters

desiredWidth int

požadovaná šírka v pixeloch

desiredHeight int

požadovaná výška v pixeloch

keepAspectRatio bool

či udržať aspektový pomer pôvodného obrazu

Remarks

Šírka a výška výstupného obrazu v pixeloch bude založená iba na požadovanej šírke a výške.

Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution a Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution nebude mať vplyv na šírku a výšku výstupného obrazu v tomto prípade.