Class ImageOrPrintOptions
De naam: Aspose.Cells.Rendering Verzameling: Aspose.Cells.dll (25.4.0)
U kunt opties specificeren bij het renderen van werkblad naar afbeeldingen, het afdrukken van werkblad of het renderen van grafiek naar afbeelding.
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()
De Ctor.
public ImageOrPrintOptions()Properties
AllColumnsInOnePagePerSheet
Als AllColumnsInOnePagePerSheet waar is, komt alle kolominhoud van één blad naar slechts één pagina in het resultaat.De breedte van de papieren grootte van het pagina-oppervlak zal ongeldig zijn, en de andere instellingen van het pagina-oppervlakHet zal nog steeds effectief zijn.
public bool AllColumnsInOnePagePerSheet { get; set; }Eigendomswaarde
ChartImageType
Geef de grafische beeldtype aan bij het converteren.De standaardwaarde: 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; }Eigendomswaarde
Remarks
Opmerking: deze lid is nu verouderd. in plaats daarvan,Chart en Shape worden altijd gepresenteerd als vectorelementen (bijvoorbeeld punt, lijn) voor de rendering van kwaliteit.Deze woning zal 12 maanden later vanaf juni 2022 worden verwijderd.Aspose verontschuldigt zich voor eventuele ongemak die u heeft ervaren.
CheckWorkbookDefaultFont
Wanneer de tekens in de Excel Unicode zijn en niet met de juiste lettertype in cellestyl worden ingesteld,Ze kunnen verschijnen als blok in pdf, afbeelding.Stel dit waar om te proberen de standaard font van het werkboek te gebruiken om deze tekens eerst te tonen.
public bool CheckWorkbookDefaultFont { get; set; }Eigendomswaarde
Remarks
De standaard is waar.
CustomPrintPageEventHandler
De klant kan bijzondere output naar de printer bij het afdrukken van elke pagina met deze EventHandler
public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }Eigendomswaarde
CustomQueryPageSettingsEventHandler
De klant kan de pagina-instelling van de printer controleren bij het afdrukken van elke pagina met behulp van deze EventHandler
public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }Eigendomswaarde
DefaultEditLanguage
Geeft of instelt standaard edit taal.
public DefaultEditLanguage DefaultEditLanguage { get; set; }Eigendomswaarde
Remarks
Het kan verschillende layouts voor tekstparagrafen weergeven/besturen wanneer verschillende bewerkings talen worden ingesteld.De standaard is Aspose.Cells.DefaultEditLanguage.Auto.
DefaultFont
Wanneer de tekens in de Excel Unicode zijn en niet met de juiste lettertype in cellestyl worden ingesteld,Ze kunnen verschijnen als blok in pdf, afbeelding.Set de DefaultFont zoals MingLiu of MS Gothic om deze karakters te tonen.Als deze eigenschap niet is ingesteld, zal Aspose.Cells gebruik maken van systeem standaard font om deze unicode tekens te tonen.
public string DefaultFont { get; set; }Eigendomswaarde
DrawObjectEventHandler
Deze interface wordt geïmplementeerd om DrawObject en Bound te krijgen bij rendering.
public DrawObjectEventHandler DrawObjectEventHandler { get; set; }Eigendomswaarde
EmbededImageNameInSvg
Geef de filename van de ingebouwde afbeelding in svg.Dit moet een volledige route zijn met directories zoals “c:\xpsEmbedded”
[Obsolete("Images are always embedded in Svg with base64 format, please remove this property.")]
[Browsable(false)]
public string EmbededImageNameInSvg { get; set; }Eigendomswaarde
EmfRenderSetting
Instellingen voor het renderen van Emf metafiles in de bronbestand.
public EmfRenderSetting EmfRenderSetting { get; set; }Eigendomswaarde
Remarks
EMF-metafiles geïdentificeerd als “EMF+ Dual” kunnen zowel EMF+ records als EMF records bevatten.Geen enkel type record kan worden gebruikt om de afbeelding te maken, alleen EMF+ records, of alleen EMF records.Wanneer Aspose.Cells.EmfRenderSetting.EmfPlusPrefer is ingesteld, worden de EMF+-records geparsd terwijl ze naar de afbeelding worden doorgegeven, anders worden alleen de EMF-records geparsd.De standaardwaarde is Aspose.Cells.EmfRenderSetting.EmfOnly.Voor de kaders die afhankelijk zijn van .Net System.Drawing.Common, wordt deze instelling geïllustreerd.
EmfType
Geeft of stelt een EmfType die het format van de Metafile specificert.
public EmfType EmfType { get; set; }Eigendomswaarde
GridlineType
Gets of sets gridline type.
public GridlineType GridlineType { get; set; }Eigendomswaarde
Remarks
De standaard is Dotted type.
HorizontalResolution
Geeft of stelt de horizontale resolutie voor geproduceerde afbeeldingen, in punten per inch.
public int HorizontalResolution { get; set; }Eigendomswaarde
Examples
De volgende code stelt de resolutie op 192, de breedte en hoogte van de gecreëerde afbeelding is twee keereen met resolutie achtergelaten als de standaardwaarde 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
De standaardwaarde is 96.
Instellingen Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution en Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution beïnvloeden de breedte en hoogte van het uitgangsbeeld in pixels.
ImageType
Geeft of stelt het formaat van de geproduceerde afbeeldingen.De standaardwaarde: PNG
public virtual ImageType ImageType { get; set; }Eigendomswaarde
IsCellAutoFit
Het geeft aan of de breedte en hoogte van de cellen automatisch worden aangepast door de celwaarde.De standaardwaarde is vals.
[Obsolete("Use Worksheet.AutoFitColumns(AutoFitterOptions) and Worksheet.AutoFitRows(AutoFitterOptions) instead.")]
[Browsable(false)]
public bool IsCellAutoFit { get; set; }Eigendomswaarde
Remarks
Opmerking: deze lid is nu verouderd. in plaats daarvan,Gebruik het werkblad Aspose.Cells.Worksheet.AutoFitColumns(_W L 27.AutofitterOptions) en __ WL 27 _.Type-opties.Deze woning zal 12 maanden later vanaf augustus 2022 worden verwijderd.Aspose verontschuldigt zich voor eventuele ongemak die u heeft ervaren.
IsFontSubstitutionCharGranularity
Hiermee wordt aangegeven of de lettertype alleen moet worden vervangen wanneer de lettertype van de cel niet compatibel is.
public bool IsFontSubstitutionCharGranularity { get; set; }Eigendomswaarde
Remarks
We proberen de standaard font van Workbook en PdfSaveOption/systeem voor cell font eerst.
IsOptimized
Het geeft aan of de outputelementen moeten worden geoptimaliseerd.
public bool IsOptimized { get; set; }Eigendomswaarde
Remarks
De standaardwaarde is vals.Op dit moment, wanneer deze eigenschap wordt vastgesteld, worden de volgende optimalisaties uitgevoerd:
- Optimaliseren van de grenslijnen.
- optimaliseren van de bestandgrootte tijdens het renderen naar Svg beeld.
OnePagePerSheet
Als OnePagePerSheet waar is, komt alle inhoud van één blad naar slechts één pagina.De papieren grootte van de pagina’s zal ongeldig zijn, en de andere instellingen van de pagina’sHet zal nog steeds effectief zijn.
public bool OnePagePerSheet { get; set; }Eigendomswaarde
OnlyArea
Als deze eigenschap waar is, zal één Area een uitkomst zijn en geen schaal zal in werking treden.
public bool OnlyArea { get; set; }Eigendomswaarde
OutputBlankPageWhenNothingToPrint
Het geeft aan of je een witte pagina moet uitgeven wanneer er niets te printen is.
public bool OutputBlankPageWhenNothingToPrint { get; set; }Eigendomswaarde
Remarks
De standaard is vals.
PageCount
Geeft of stelt het aantal pagina’s om te besparen.
public int PageCount { get; set; }Eigendomswaarde
Remarks
De standaard is System.Int32.MaxValue wat betekent dat alle pagina’s worden gepresenteerd.
PageIndex
Geeft of stelt de 0-gebaseerde index van de eerste pagina te besparen.
public int PageIndex { get; set; }Eigendomswaarde
Remarks
De standaard is 0.
PageSavingCallback
Controleer/indiceer de vooruitgang van het pagina-opslaanproces.
public IPageSavingCallback PageSavingCallback { get; set; }Eigendomswaarde
PixelFormat
Geeft of stelt het pixelformaat voor de geproduceerde afbeeldingen.
public PixelFormat PixelFormat { get; set; }Eigendomswaarde
Remarks
De standaardwaarde is PixelFormat.Format32bppArgb.
PrintWithStatusDialog
Als PrintWithStatusDialog = waar is, zal er een dialoog zijn die de huidige drukstatus toont.Anders zal er geen dergelijke dialoog ontstaan.
public bool PrintWithStatusDialog { get; set; }Eigendomswaarde
PrintingPage
Het geeft aan welke pagina’s niet worden gedrukt.
public PrintingPageType PrintingPage { get; set; }Eigendomswaarde
Quality
Geeft of stelt een waarde die de kwaliteit van de gecreëerde imagesto bepaalt, geldt alleen wanneer pagina’s worden opgeslagen in het ‘Jpeg’-formaat.
public int Quality { get; set; }Eigendomswaarde
Remarks
Dit geldt alleen voor het opslaan in JPEG.De waarde moet tussen 0 en 100 zijn.De standaardwaarde is 100.
SVGFitToViewPort
Als deze eigenschap waar is, zal de geïntroduceerde SVG geschikt zijn voor het bekijken van de haven.
[Obsolete("Use SvgImageOptions.FitToViewPort property instead.")]
[Browsable(false)]
public bool SVGFitToViewPort { get; set; }Eigendomswaarde
SaveFormat
Geeft of stelt de output-bestandformaat typeOndersteuning Tiff/XPS
[Obsolete("For Tiff/Svg, use ImageType; For Xps, use Workbook.Save(string, SaveOptions) with XpsSaveOptions")]
[Browsable(false)]
public SaveFormat SaveFormat { get; set; }Eigendomswaarde
Remarks
Opmerking: deze lid is nu verouderd. in plaats daarvan,Voor Tiff/Svg, gebruik Aspose.Cells.Rendering.ImageOrPrintOptions.ImmageType; voor Xps gebruikt u __ WL26_.Workbook.Save(System.String,W L 27 .Saveropties) met _wL25 .XpsSavOpties.Deze woning zal 12 maanden later vanaf augustus 2022 worden verwijderd.Aspose verontschuldigt zich voor eventuele ongemak die u heeft ervaren.
SheetSet
De standaard is alle zichtbare bladeren in het werkboek: Aspose.Cells.Rendering.SheetSet.Visible.
public SheetSet SheetSet { get; set; }Eigendomswaarde
Remarks
De set wordt verwaarloosd wanneer het wordt gebruikt in Aspose.Cells.Rendering.SheetRender
SmoothingMode
Specificeert of smelting (antialiasing) wordt toegepast op lijnen en curves en de rand van gevuld gebieden.De standaardwaarde is SmoothingMode.None
public SmoothingMode SmoothingMode { get; set; }Eigendomswaarde
SvgCssPrefix
Geeft en stelt de prefix van de css-naam in svg,de standaardwaarde is leeg string.
[Obsolete("Use SvgImageOptions.CssPrefix property instead.")]
[Browsable(false)]
public string SvgCssPrefix { get; set; }Eigendomswaarde
TextCrossType
Geeft of instelt tekst type wanneer de tekstbreedte groter is dan de celbreedte.
public TextCrossType TextCrossType { get; set; }Eigendomswaarde
TextRenderingHint
Het bepaalt de kwaliteit van de tekst rendering.De standaardwaarde is TextRenderingHint.SystemDefault
public TextRenderingHint TextRenderingHint { get; set; }Eigendomswaarde
TiffBinarizationMethod
Geeft of zet de methode die wordt gebruikt bij het converteren van afbeeldingen naar 1 bpp formatwanneer Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType is Tiff en Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompression is gelijk aan Ccitt3 of Ccitt4.
public ImageBinarizationMethod TiffBinarizationMethod { get; set; }Eigendomswaarde
Remarks
De standaardwaarde is FloydSteinbergDithering.
TiffColorDepth
Geeft of instelt een bit diepte om alleen toe te passen wanneer pagina’s worden opgeslagen in het ‘Tiff’-formaat.
public ColorDepth TiffColorDepth { get; set; }Eigendomswaarde
Remarks
Het werkt alleen bij het besparen aan TIFF.Als TiffCompression is ingesteld op CCITT3, CCITT4, zal dit niet in werking treden, zal de bitdiepte van het genereren tiff beeld altijd 1 zijn.
TiffCompression
Geeft of stelt het type compressie alleen toe wanneer de pagina’s worden opgeslagen in het ‘Tiff’-formaat.
public TiffCompression TiffCompression { get; set; }Eigendomswaarde
Remarks
Het werkt alleen bij het besparen aan TIFF.De standaardwaarde is Lzw.
Transparent
Het geeft aan of de achtergrond van het geproduceerde beeld transparant moet zijn.
public bool Transparent { get; set; }Eigendomswaarde
Remarks
De standaardwaarde is vals, wat betekent dat de achtergrond van de gecreëerde afbeeldingen wit is.
VerticalResolution
Geeft of stelt de verticale resolutie voor geproduceerde afbeeldingen, in punten per inch.
public int VerticalResolution { get; set; }Eigendomswaarde
Examples
De volgende code stelt de resolutie op 192, de breedte en hoogte van de gecreëerde afbeelding is twee keereen met resolutie achtergelaten als de standaardwaarde 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
De standaardwaarde is 96.
Instellingen Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution en Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution beïnvloeden de breedte en hoogte van het uitgangsbeeld in pixels.
WarningCallback
Geeft of zet een waarschuwing callback.
public IWarningCallback WarningCallback { get; set; }Eigendomswaarde
Methods
SetDesiredSize(int, int)
Set de gewenste breedte en hoogte van het beeld.
[Obsolete("Use SetDesiredSize(int, int, bool) by setting param keepAspectRatio to false instead.")]
public void SetDesiredSize(int desiredWidth, int desiredHeight)Parameters
desiredWidth int
De gewenste breedte in pixels
desiredHeight int
De gewenste hoogte in pixels
Remarks
Opmerking: deze lid is nu verouderd. in plaats daarvan,Gebruik Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) door de parameter te plaatsen om AspectRatio te houden.Deze woning zal 12 maanden later vanaf mei 2023 worden verwijderd.Aspose verontschuldigt zich voor eventuele ongemak die u heeft ervaren.
SetDesiredSize(int, int, bool)
Set de gewenste breedte en hoogte van het beeld.
public void SetDesiredSize(int desiredWidth, int desiredHeight, bool keepAspectRatio)Parameters
desiredWidth int
De gewenste breedte in pixels
desiredHeight int
De gewenste hoogte in pixels
keepAspectRatio bool
houd het aspect ratio van oorsprong beeld
Remarks
De breedte en hoogte van het uitgangsbeeld in pixels zal alleen gebaseerd zijn op de gewenste breedte en hoogte.
De Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution en Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution zal in dit geval de breedte en hoogte van het output beeld niet beïnvloeden.
