Class ImageOrPrintOptions
Il nome: Aspose.Cells.Rendering Assemblea: Aspose.Cells.dll (25.4.0)
Permette di specificare le opzioni quando rendere la scheda di lavoro alle immagini, stampare la scheda di lavoro o rendere la scheda all’immagine.
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()
di Ctor.
public ImageOrPrintOptions()Properties
AllColumnsInOnePagePerSheet
Se AllColumnsInOnePagePerSheet è vero, il contenuto di tutte le colonne di una scheda verrà rilasciato a una sola pagina nel risultato.La larghezza di carta del setup di pagine sarà invalida e le altre impostazioni del setup di pagine saranno invalide.continuerà ad avere effetto.
public bool AllColumnsInOnePagePerSheet { get; set; }Valore di proprietà
ChartImageType
Indica il tipo di immagine del grafico al momento della conversione.Valore di default: 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; }Valore di proprietà
Remarks
Nota: questo membro è ormai obsoleto. invece,Il grafico e la forma sono sempre renderati come elementi vettori (ad esempio punto, linea) per renderare la qualità.Questa proprietà sarà rimossa 12 mesi dopo a partire da giugno 2022.Aspose scusa per qualsiasi inconveniente che potresti aver sperimentato.
CheckWorkbookDefaultFont
Quando i caratteri in Excel sono Unicode e non sono impostati con la font corretta in stile cellulare,Può apparire come blocco in pdf, immagine.Imposta questo per cercare di utilizzare la font predefinita del libro di lavoro per visualizzare questi caratteri prima.
public bool CheckWorkbookDefaultFont { get; set; }Valore di proprietà
Remarks
Il default è vero.
CustomPrintPageEventHandler
Il Cliente può stampare un’output speciale quando stampa ogni pagina utilizzando questo EventHandler
public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }Valore di proprietà
CustomQueryPageSettingsEventHandler
Il Cliente può controllare le impostazioni della pagina della stampante quando stampa ogni pagina utilizzando questo EventHandler
public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }Valore di proprietà
DefaultEditLanguage
Riceve o impone il linguaggio di edit default.
public DefaultEditLanguage DefaultEditLanguage { get; set; }Valore di proprietà
Remarks
Può visualizzare/render layout diversi per paragrafo di testo quando sono impostati diversi linguaggi di modifica.Il default è Aspose.Cells.DefaultEditLanguage.Auto.
DefaultFont
Quando i caratteri in Excel sono Unicode e non sono impostati con la font corretta in stile cellulare,Può apparire come blocco in pdf, immagine.Imposta il DefaultFont come MingLiu o MS Gothic per visualizzare questi caratteri.Se questa proprietà non è impostata, Aspose.Cells utilizzerà la font predefinita del sistema per visualizzare questi caratteri unicode.
public string DefaultFont { get; set; }Valore di proprietà
DrawObjectEventHandler
Implementa questa interfaccia per ottenere DrawObject e Bound durante il rendering.
public DrawObjectEventHandler DrawObjectEventHandler { get; set; }Valore di proprietà
EmbededImageNameInSvg
Indica il nome filename dell’immagine incorporata in svg.Questo dovrebbe essere il percorso completo con directory come “c:\xpsEmbedded”
[Obsolete("Images are always embedded in Svg with base64 format, please remove this property.")]
[Browsable(false)]
public string EmbededImageNameInSvg { get; set; }Valore di proprietà
EmfRenderSetting
Impostazione per rendere i metafili EMF nel file sorgente.
public EmfRenderSetting EmfRenderSetting { get; set; }Valore di proprietà
Remarks
I metafili EMF identificati come “EMF+ Dual” possono contenere sia i record EMF+ che i record EMF.Qualsiasi tipo di record può essere utilizzato per rendere l’immagine, solo i record EMF+ o solo i record EMF.Quando Aspose.Cells.EmfRenderSetting.EmfPlusPrefer è impostato, allora i record EMF+ saranno parsed mentre renderanno all’immagine, altrimenti solo i record EMF saranno parsed.Il valore di default è Aspose.Cells.EmfRenderSetting.EmfOnly.Per i framework che dipendono da .Net System.Drawing.Common, questa impostazione è ignorata.
EmfType
Riceve o impone un EmfType che specifica il formato del Metafile..
public EmfType EmfType { get; set; }Valore di proprietà
GridlineType
Ottenere o impostare il tipo di gridline.
public GridlineType GridlineType { get; set; }Valore di proprietà
Remarks
La tipologia è Dotted Type.
HorizontalResolution
Riceve o impone la risoluzione orizzontale per le immagini generate, in punti per pollice.
public int HorizontalResolution { get; set; }Valore di proprietà
Examples
Il codice seguente stabilisce la risoluzione a 192, la larghezza e l’altezza dell’immagine generata sono due volte piùL’uno con risoluzione è rimasto come il valore predefinito 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
Il valore di default è 96.
Impostazioni Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution e Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution influenzano la larghezza e l’altezza dell’immagine di uscita in pixel.
ImageType
Riceve o impone il formato delle immagini generate.Valore di default: PNG
public virtual ImageType ImageType { get; set; }Valore di proprietà
IsCellAutoFit
Indica se la larghezza e l’altezza delle cellule sono automaticamente adattate al valore cellulare.Il valore default è falso.
[Obsolete("Use Worksheet.AutoFitColumns(AutoFitterOptions) and Worksheet.AutoFitRows(AutoFitterOptions) instead.")]
[Browsable(false)]
public bool IsCellAutoFit { get; set; }Valore di proprietà
Remarks
Nota: questo membro è ormai obsoleto. invece,Si prega di usare Aspose.Cells.Worksheet.AutoFitColumns(_W L 27.AutofitterOptions) e __ WL 27 _.Archivio.Questa proprietà sarà rimossa 12 mesi dopo agosto 2022.Aspose scusa per qualsiasi inconveniente che potresti aver sperimentato.
IsFontSubstitutionCharGranularity
Indica se sostituire il carattere solo quando il carattere cellulare non è compatibile con esso.
public bool IsFontSubstitutionCharGranularity { get; set; }Valore di proprietà
Remarks
Proveremo la font predefinita di Workbook e PdfSaveOption/system per la font cellulare prima.
IsOptimized
Indica se ottimizzare gli elementi di produzione.
public bool IsOptimized { get; set; }Valore di proprietà
Remarks
Il valore default è falso.Attualmente, quando questa proprietà è fissata, verranno effettuate le seguenti ottimizzazioni:
- Ottimizzare le linee di frontiera.
- ottimizzare la dimensione del file mentre rendendo all’immagine Svg.
OnePagePerSheet
Se OnePagePerSheet è vero, tutti i contenuti di una scheda usciranno a una sola pagina.La dimensione del foglio di pagina sarà invalida e le altre impostazioni del foglio di pagina saranno invalidecontinuerà ad avere effetto.
public bool OnePagePerSheet { get; set; }Valore di proprietà
OnlyArea
Se questa proprietà è vera, un’area sarà la produzione, e nessuna scala avrà effetto.
public bool OnlyArea { get; set; }Valore di proprietà
OutputBlankPageWhenNothingToPrint
Indica se produrre una pagina bianca quando non c’è nulla da stampare.
public bool OutputBlankPageWhenNothingToPrint { get; set; }Valore di proprietà
Remarks
Il default è falso.
PageCount
Riceve o impone il numero di pagine da salvare.
public int PageCount { get; set; }Valore di proprietà
Remarks
Default è System.Int32.MaxValue che significa che tutte le pagine saranno renderate.
PageIndex
Riceve o impone l’indice basato su 0 della prima pagina da salvare.
public int PageIndex { get; set; }Valore di proprietà
Remarks
Il default è 0.
PageSavingCallback
Controllo/indicazione del progresso del processo di salvataggio della pagina.
public IPageSavingCallback PageSavingCallback { get; set; }Valore di proprietà
PixelFormat
Riceve o impone il formato del pixel per le immagini generate.
public PixelFormat PixelFormat { get; set; }Valore di proprietà
Remarks
Il valore predefinito è PixelFormat.Format32bppArgb.
PrintWithStatusDialog
Se PrintWithStatusDialog = vero, ci sarà un dialogo che mostra lo stato di stampa corrente.Altrimenti, questo dialogo non si dimostrerà.
public bool PrintWithStatusDialog { get; set; }Valore di proprietà
PrintingPage
Indica quali pagine non saranno stampate.
public PrintingPageType PrintingPage { get; set; }Valore di proprietà
Quality
Riceve o impone un valore che determina la qualità dell’immagine generata si applica solo quando le pagine vengono salvate nel formato ‘Jpeg’.
public int Quality { get; set; }Valore di proprietà
Remarks
Funziona solo quando si risparmia in JPEG.Il valore deve essere tra 0 e 100.Il valore default è 100.
Sviluppo di SVGFitToViewPort
se questa proprietà è vera, il svg generato sarà adatto per visualizzare il porto.
[Obsolete("Use SvgImageOptions.FitToViewPort property instead.")]
[Browsable(false)]
public bool SVGFitToViewPort { get; set; }Valore di proprietà
SaveFormat
Riceve o impone il tipo di formato del file di uscitaSupporto Tiff/XPS
[Obsolete("For Tiff/Svg, use ImageType; For Xps, use Workbook.Save(string, SaveOptions) with XpsSaveOptions")]
[Browsable(false)]
public SaveFormat SaveFormat { get; set; }Valore di proprietà
Remarks
Nota: questo membro è ormai obsoleto. invece,Per Tiff/Svg, utilizzare Aspose.Cells.Rendering.ImageOrPrintOptions.ImmageType; per Xps, usare __ WL27.Workbook.Save(System.String,_Wl27.saveoptions) con __VL37.XpsSavOption.Questa proprietà sarà rimossa 12 mesi dopo agosto 2022.Aspose scusa per qualsiasi inconveniente che potresti aver sperimentato.
SheetSet
Riceve o impone le foglie per rendere. Default è tutte le foglie visibili nel libretto di lavoro: Aspose.Cells.Rendering.SheetSet.Visible.
public SheetSet SheetSet { get; set; }Valore di proprietà
Remarks
Il set è ignorato quando viene utilizzato in Aspose.Cells.Rendering.SheetRender
SmoothingMode
Determinerà se si applicano le linee e le curve e i confini delle aree riempite.Il valore di default è SmoothingMode.None
public SmoothingMode SmoothingMode { get; set; }Valore di proprietà
SvgCssPrefix
Riceve e impone il prefix del nome css in svg,il valore predefinito è la riga vuota.
[Obsolete("Use SvgImageOptions.CssPrefix property instead.")]
[Browsable(false)]
public string SvgCssPrefix { get; set; }Valore di proprietà
TextCrossType
Riceve o imposta il tipo di testo quando la larghezza del testo è più grande della larghezza della cellula.
public TextCrossType TextCrossType { get; set; }Valore di proprietà
TextRenderingHint
Determinare la qualità del testo rendering.Il valore di default è TextRenderingHint.SystemDefault
public TextRenderingHint TextRenderingHint { get; set; }Valore di proprietà
TiffBinarizationMethod
Riceve o impone il metodo utilizzato durante la conversione delle immagini in formato 1 bppQuando Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType è Tiff e Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompression è uguale a Ccitt3 o Ccitt4.
public ImageBinarizationMethod TiffBinarizationMethod { get; set; }Valore di proprietà
Remarks
Il valore di default è FloydSteinbergDithering.
TiffColorDepth
Riceve o impone bit di profondità per applicare solo quando si salve pagine nel formato ‘Tiff’.
public ColorDepth TiffColorDepth { get; set; }Valore di proprietà
Remarks
Funziona solo quando si risparmia a TIFF.Se TiffCompression è impostato a CCITT3, CCITT4, questo non avrà effetto, la profondità del bit dell’immagine tiff generata sarà sempre 1.
TiffCompression
Riceve o impone il tipo di compressione da applicare solo quando salva le pagine nel formato ‘Tiff’.
public TiffCompression TiffCompression { get; set; }Valore di proprietà
Remarks
Funziona solo quando si risparmia a TIFF.Il valore di default è Lzw.
Transparent
Indica se il background dell’immagine generata dovrebbe essere trasparente.
public bool Transparent { get; set; }Valore di proprietà
Remarks
Il valore predefinito è falso, il che significa che il background delle immagini generate è bianco.
VerticalResolution
Riceve o impone la risoluzione verticale per le immagini generate, in punti per pollice.
public int VerticalResolution { get; set; }Valore di proprietà
Examples
Il codice seguente stabilisce la risoluzione a 192, la larghezza e l’altezza dell’immagine generata sono due volte piùL’uno con risoluzione è rimasto come il valore predefinito 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
Il valore di default è 96.
Impostazioni Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution e Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution influenzano la larghezza e l’altezza dell’immagine di uscita in pixel.
WarningCallback
Riceve o mette un avvertimento callback.
public IWarningCallback WarningCallback { get; set; }Valore di proprietà
Methods
SetDesiredSize(di int, int)
Imposta la larghezza e l’altezza desiderata dell’immagine.
[Obsolete("Use SetDesiredSize(int, int, bool) by setting param keepAspectRatio to false instead.")]
public void SetDesiredSize(int desiredWidth, int desiredHeight)Parameters
desiredWidth int
Spessore desiderato in pixel
desiredHeight int
L’altezza desiderata in pixel
Remarks
Nota: questo membro è ormai obsoleto. invece,Si prega di utilizzare Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) impostando il parametro per mantenere AspectRatio falso.Questa proprietà sarà rimossa 12 mesi dopo maggio 2023.Aspose scusa per qualsiasi inconveniente che potresti aver sperimentato.
SetDesiredSize(int, int e bool)
Imposta la larghezza e l’altezza desiderata dell’immagine.
public void SetDesiredSize(int desiredWidth, int desiredHeight, bool keepAspectRatio)Parameters
desiredWidth int
Spessore desiderato in pixel
desiredHeight int
L’altezza desiderata in pixel
keepAspectRatio bool
Per mantenere la proporzione dell’immagine di origine
Remarks
La larghezza e l’altezza dell’immagine di uscita in pixel sarà basata solo sulla larghezza e l’altezza desiderate.
Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution e Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution non influenzerà la larghezza e l’altezza dell’immagine di uscita in questo caso.
