Class ImageOrPrintOptions

Namn på plats: Aspose.Cells.Rendering Sammanfattning: Aspose.Cells.dll (25.4.0)

Tillåter att ange alternativ när du renderar arbetsblad till bilder, trycker arbetsblad eller renderar diagram till bild.

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

och ctor.

public ImageOrPrintOptions()

Properties

AllColumnsInOnePagePerSheet

Om AllColumnsInOnePagePerSheet är sant kommer alla kolumninnehåll i ett blad att komma ut till bara en sida i resultatet.Längden på pappersstorleken för sidstopp kommer att vara ogiltig, och de andra inställningarna för sidstoppkommer fortfarande att träda i kraft.

public bool AllColumnsInOnePagePerSheet { get; set; }

Fastighetsvärde

bool

ChartImageType

Ange diagrambildstypen när du konverterar.Standardvärde: 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; }

Fastighetsvärde

ImageFormat

Remarks

NOTE: Denna medlem är nu föråldrad. i stället,Chart och Shape renderas alltid som vektorelement (t.ex. punkt, linje) för rendering av kvalitet.Denna fastighet kommer att tas bort 12 månader senare från juni 2022.Aspose ber om ursäkt för eventuella obehag du kan ha upplevt.

CheckWorkbookDefaultFont

När tecken i Excel är Unicode och inte ställs in med rätt font i cellstil,De kan visas som block i pdf, bild.Sätt detta till sant för att försöka använda arbetsbokens standardformulär för att visa dessa tecken först.

public bool CheckWorkbookDefaultFont { get; set; }

Fastighetsvärde

bool

Remarks

Undantaget är sant.

CustomPrintPageEventHandler

Kunden kan skriva ut en särskild utgång till skrivaren när varje sida skrivs ut med denna EventHandler

public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }

Fastighetsvärde

PrintPageEventHandler

CustomQueryPageSettingsEventHandler

Kunden kan styra sidinställningarna för skrivaren när du skriver ut varje sida med hjälp av denna EventHandler

public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }

Fastighetsvärde

QueryPageSettingsEventHandler

DefaultEditLanguage

Få eller ställa in standardredigeringsspråk.

public DefaultEditLanguage DefaultEditLanguage { get; set; }

Fastighetsvärde

DefaultEditLanguage

Remarks

Det kan visa/lämna olika layouter för textparagrafen när olika redigeringsspråk är inställda.Standard är Aspose.Cells.DefaultEditLanguage.Auto.

DefaultFont

När tecken i Excel är Unicode och inte ställs in med rätt font i cellstil,De kan visas som block i pdf, bild.Ställ in DefaultFont som MingLiu eller MS Gothic för att visa dessa tecken.Om denna egenskap inte är inställd kommer Aspose.Cells att använda standardfönstret för att visa dessa unicode tecken.

public string DefaultFont { get; set; }

Fastighetsvärde

string

DrawObjectEventHandler

Implementera detta gränssnitt för att få DrawObject och Bound vid rendering.

public DrawObjectEventHandler DrawObjectEventHandler { get; set; }

Fastighetsvärde

DrawObjectEventHandler

EmbededImageNameInSvg

Ange filnamnet på den inbyggda bilden i svg.Detta bör vara den fullständiga vägen med kataloger som “c:\xpsEmbedded”

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

Fastighetsvärde

string

EmfRenderSetting

Inställningar för rendering av EMF metafiler i källfilen.

public EmfRenderSetting EmfRenderSetting { get; set; }

Fastighetsvärde

EmfRenderSetting

Remarks

EMF-metafiler som identifierats som “EMF+ Dual” kan innehålla både EMF+- och EMF-filer.Varje typ av inspelning kan användas för att återge bilden, endast EMF+ inspelningar, eller bara EMF inspelningar.När Aspose.Cells.EmfRenderSetting.EmfPlusPrefer är inställd, kommer EMF+-filer att parsas medan de renderas till bilden, annars kommer endast EMF-filer att parsas.Standardvärdet är Aspose.Cells.EmfRenderSetting.EmfOnly.För de ramar som är beroende av .Net System.Drawing.Common ignoreras denna inställning.

EmfType

Få eller ställa in en EmfType som anger formatet för Metafile..Det standardvärdet är EmfPlusDual.

public EmfType EmfType { get; set; }

Fastighetsvärde

EmfType

GridlineType

Gets eller sätter gridline typ.

public GridlineType GridlineType { get; set; }

Fastighetsvärde

GridlineType

Remarks

Default är Dotted typ.

HorizontalResolution

Få eller ställa in horisontell upplösning för genererade bilder, i punkter per tum.

public int HorizontalResolution { get; set; }

Fastighetsvärde

int

Examples

Följande kod sätter upplösning till 192, bredden och höjden på den genererade bilden är dubbelt så hög somDen med upplösning lämnas som standardvärdet 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

Standardvärdet är 96.

Inställningar Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution och Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution påverkar bredden och höjden av utgångsbilden i pixlar.

ImageType

Få eller ställa in formatet för de genererade bilderna.Standardvärde: PNG

public virtual ImageType ImageType { get; set; }

Fastighetsvärde

ImageType

IsCellAutoFit

Anger om bredden och höjden på cellerna automatiskt justeras av cellvärdet.Det standardvärdet är falskt.

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

Fastighetsvärde

bool

Remarks

NOTE: Denna medlem är nu föråldrad. i stället,Vänligen använd Aspose.Cells.Worksheet.AutoFitColumns(_W L 27.OutofitterOptions) och _Wl 27 _.Tillverkare.Denna fastighet kommer att tas bort 12 månader senare från augusti 2022.Aspose ber om ursäkt för eventuella obehag du kan ha upplevt.

IsFontSubstitutionCharGranularity

Anger om du endast ska ersätta teckensnittet när cellens teckensnitt inte är kompatibel med det.

public bool IsFontSubstitutionCharGranularity { get; set; }

Fastighetsvärde

bool

Remarks

Vi kommer att prova standardformuläret Workbook och PdfSaveOption/system för cellformulär först.

IsOptimized

Anger om du ska optimera produktionselementen.

public bool IsOptimized { get; set; }

Fastighetsvärde

bool

Remarks

Standardvärdet är falskt.För närvarande, när denna egendom är inställd till verklighet, kommer följande optimeringar att göras:

Optimera gränslinjerna.
Optimera filstorleken samtidigt som du renderar till Svg-bild.

OnePagePerSheet

Om OnePagePerSheet är sant kommer allt innehåll i ett blad att komma ut till bara en sida i resultatet.Pappersstorleken på sidetupen är ogiltig, och de övriga sidetupinställningarnakommer fortfarande att träda i kraft.

public bool OnePagePerSheet { get; set; }

Fastighetsvärde

bool

OnlyArea

Om denna egendom är sant, kommer ett område att vara produktion, och ingen skala kommer att träda i kraft.

public bool OnlyArea { get; set; }

Fastighetsvärde

bool

OutputBlankPageWhenNothingToPrint

Anger om du ska producera en vit sida när det inte finns något att skriva ut.

public bool OutputBlankPageWhenNothingToPrint { get; set; }

Fastighetsvärde

bool

Remarks

Undantaget är falskt.

PageCount

Få eller ställa in antalet sidor att spara.

public int PageCount { get; set; }

Fastighetsvärde

int

Remarks

Standard är System.Int32.MaxValue vilket innebär att alla sidor kommer att renderas.

PageIndex

Få eller ställa in 0-baserad index på den första sidan att spara.

public int PageIndex { get; set; }

Fastighetsvärde

int

Remarks

Undantaget är 0.

PageSavingCallback

Kontrollera/Indicera framsteg i sidan spara processen.

public IPageSavingCallback PageSavingCallback { get; set; }

Fastighetsvärde

IPageSavingCallback

PixelFormat

Få eller ställa in pixelformat för de genererade bilderna.

public PixelFormat PixelFormat { get; set; }

Fastighetsvärde

PixelFormat

Remarks

Det standardvärdet är PixelFormat.Format32bppArgb.

PrintWithStatusDialog

Om PrintWithStatusDialog = sant, kommer det att finnas en dialog som visar den aktuella tryckstatus.Annars kommer ingen sådan dialog att visas.

public bool PrintWithStatusDialog { get; set; }

Fastighetsvärde

bool

PrintingPage

Ange vilka sidor som inte kommer att skrivas ut.

public PrintingPageType PrintingPage { get; set; }

Fastighetsvärde

PrintingPageType

Quality

Få eller ange ett värde som bestämmer kvaliteten på den genererade imagesto gäller endast när du sparar sidor i JPEG-format.

public int Quality { get; set; }

Fastighetsvärde

int

Remarks

Det fungerar endast när du sparar till JPEG.Värdet måste vara mellan 0 och 100.Det standardvärdet är 100.

SVGFitToViewPort

om denna egendom är sann, kommer den genererade svg att passa för att se hamnen.

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

Fastighetsvärde

bool

SaveFormat

Få eller ställa in utgångsfilformatet typStöd för Tiff/XPS

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

Fastighetsvärde

SaveFormat

Remarks

NOTE: Denna medlem är nu föråldrad. i stället,För Tiff/Svg, använd Aspose.Cells.Rendering.ImageOrPrintOptions.ImmageType; För Xps använder du Wl27.Workbook.Save(System.String,W L 27 .Savoptions) med _ WL27.Denna fastighet kommer att tas bort 12 månader senare från augusti 2022.Aspose ber om ursäkt för eventuella obehag du kan ha upplevt.

SheetSet

Standard är alla synliga blad i arbetsboken: Aspose.Cells.Rendering.SheetSet.Visible.

public SheetSet SheetSet { get; set; }

Fastighetsvärde

SheetSet

Remarks

Sättet ignoreras när det används i Aspose.Cells.Rendering.SheetRender

SmoothingMode

Anger om smidighet (antialiasing) tillämpas på linjer och kurvor och gränserna av fyllda områden.Standardvärdet är SmoothingMode.None

public SmoothingMode SmoothingMode { get; set; }

Fastighetsvärde

SmoothingMode

SvgCssPrefix

Få och ställa in prefixet för css-namnet i svg,det standardvärdet är tomt sträng.

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

Fastighetsvärde

string

TextCrossType

Det får eller ställer in texttyp när textbredden är större än cellbredden.

public TextCrossType TextCrossType { get; set; }

Fastighetsvärde

TextCrossType

TextRenderingHint

Anger kvaliteten på text rendering.Standardvärdet är TextRenderingHint.SystemDefault

public TextRenderingHint TextRenderingHint { get; set; }

Fastighetsvärde

TextRenderingHint

TiffBinarizationMethod

Få eller ange metoden som används när du konverterar bilder till 1 bpp formatnär Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType är Tiff och Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompression är lika med Ccitt3 eller Ccitt4.

public ImageBinarizationMethod TiffBinarizationMethod { get; set; }

Fastighetsvärde

ImageBinarizationMethod

Remarks

Det standardvärdet är FloydSteinbergDithering.

TiffColorDepth

Få eller ställa in bitdjup att tillämpa endast när du sparar sidor i “Tiff” formatet.

public ColorDepth TiffColorDepth { get; set; }

Fastighetsvärde

ColorDepth

Remarks

Det fungerar endast när du sparar till TIFF.Om TiffCompression är inställd på CCITT3, CCITT4, kommer detta inte att träda i kraft, bitdjupet av den genererade tiffbilden kommer alltid att vara 1.

TiffCompression

Få eller ställa in kompressionstypen att tillämpa endast när du sparar sidor i “Tiff” formatet.

public TiffCompression TiffCompression { get; set; }

Fastighetsvärde

TiffCompression

Remarks

Det fungerar endast när du sparar till TIFF.Standardvärdet är Lzw.

Transparent

Anger om bakgrunden för den genererade bilden ska vara transparent.

public bool Transparent { get; set; }

Fastighetsvärde

bool

Remarks

Standardvärdet är falsk. Det betyder att bakgrunden för de genererade bilderna är vit.

VerticalResolution

Få eller ställa in vertikal upplösning för genererade bilder, i punkter per tum.

public int VerticalResolution { get; set; }

Fastighetsvärde

int

Examples

Följande kod sätter upplösning till 192, bredden och höjden på den genererade bilden är dubbelt så hög somDen med upplösning lämnas som standardvärdet 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

Standardvärdet är 96.

WarningCallback

Få eller ställa in en varning callback.

public IWarningCallback WarningCallback { get; set; }

Fastighetsvärde

IWarningCallback

Methods

SetDesiredSize(int, int)

Ange önskad bredd och höjd av bilden.

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

Parameters

desiredWidth int

önskad bredd i pixlar

desiredHeight int

önskad höjd i pixlar

Remarks

NOTE: Denna medlem är nu föråldrad. i stället,Vänligen använda Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) genom att ställa in parametrar för att hålla AspectRatio falsk.Denna fastighet kommer att tas bort 12 månader senare från maj 2023.Aspose ber om ursäkt för eventuella obehag du kan ha upplevt.

SetDesiredSize(int, int, bool)

Ange önskad bredd och höjd av bilden.

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

Parameters

desiredWidth int

önskad bredd i pixlar

desiredHeight int

önskad höjd i pixlar

keepAspectRatio bool

huruvida man behåller aspekt proportion av ursprungsbild

Remarks

bredden och höjden på utgångsbilden i pixlar kommer endast att baseras på den önskade bredden och höjden.

Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution och Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution kommer inte att påverka bredden och höjden av utgångsbilden i detta fall.