Class ImageOrPrintOptions
Nom dels espais: Aspose.Cells.Rendering Assemblea: Aspose.Cells.dll (25.4.0)
Permet especificar opcions en renderitzar la taula de treball a les imatges, imprimir la taula de treball o renderitzar el gràfic a la imatge.
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()
El Ctor.
public ImageOrPrintOptions()Properties
AllColumnsInOnePagePerSheet
Si AllColumnsInOnePagePerSheet és veritable, tot el contingut de columnes d’una fila es produirà a només una pàgina en el resultat.L’amplada de la mida de paper del set de pàgines serà invalidada, i les altres configuracions del set de pàginesEncara tindrà efecte.
public bool AllColumnsInOnePagePerSheet { get; set; }Valor de la propietat
ChartImageType
Indica el tipus d’imatge del gràfic quan es converteix.Valoració de la funció: 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; }Valor de la propietat
Remarks
NOTA: Aquest membre és ara obsolet. en lloc,El gràfic i la forma sempre es renderen com a elements vectors (per exemple, punt, línia) per a la renderització de la qualitat.Aquesta propietat es retirarà 12 mesos més tard des de juny de 2022.Aspose s’excusa per qualsevol inconvenient que pugui haver experimentat.
CheckWorkbookDefaultFont
Quan els caràcters de l’Excel són Unicode i no s’estableix la font correcta en estil de cèl·lula,Poden aparèixer com a bloc en pdf, imatge.Establir això a veritat per tractar d’utilitzar la font estàndard del llibre de treball per mostrar aquests caràcters primer.
public bool CheckWorkbookDefaultFont { get; set; }Valor de la propietat
Remarks
El defecte és veritat.
CustomPrintPageEventHandler
El client pot obtenir una sortida especial per imprimir quan imprimeix cada pàgina utilitzant aquest EventHandler
public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }Valor de la propietat
CustomQueryPageSettingsEventHandler
El client pot controlar la configuració de la pàgina de la impresora quan imprimeix cada pàgina utilitzant aquest EventHandler
public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }Valor de la propietat
DefaultEditLanguage
Obtenir o configurar el llenguatge d’editació de default.
public DefaultEditLanguage DefaultEditLanguage { get; set; }Valor de la propietat
Remarks
Pot mostrar/render diferents dissenys per a paràgrafs de text quan s’estableixen diferents llengües d’edici.Default és Aspose.Cells.DefaultEditLanguage.Auto.
DefaultFont
Quan els caràcters de l’Excel són Unicode i no s’estableix la font correcta en estil de cèl·lula,Poden aparèixer com a bloc en pdf, imatge.Configura el DefaultFont com MingLiu o MS Gothic per mostrar aquests caràcters.Si aquesta propietat no està configurada, Aspose.Cells utilitzarà la font de sistema per mostrar aquests caràcters unicode.
public string DefaultFont { get; set; }Valor de la propietat
DrawObjectEventHandler
Implementar aquesta interfície per obtenir DrawObject i Bound quan es rendi.
public DrawObjectEventHandler DrawObjectEventHandler { get; set; }Valor de la propietat
EmbededImageNameInSvg
Indica el nom de fil de la imatge incorporada en svg.Aquest hauria de ser el camí complet amb directoris com “c:\xpsEmbedded”
[Obsolete("Images are always embedded in Svg with base64 format, please remove this property.")]
[Browsable(false)]
public string EmbededImageNameInSvg { get; set; }Valor de la propietat
EmfRenderSetting
Configuració per rendir metafísics EMF en el fitxer de font.
public EmfRenderSetting EmfRenderSetting { get; set; }Valor de la propietat
Remarks
Els metàfils EMF identificats com a “EMF+ Dual” poden contenir tant els registres EMF+ com els registres EMF.Qualsevol tipus d’enregistrament es pot utilitzar per fer la imatge, només enregistraments EMF+ o només enregistraments EMF.Quan s’estableix Aspose.Cells.EmfRenderSetting.EmfPlusPrefer, llavors els registres EMF+ es parseguen mentre es renden a la imatge, si no només els registres EMF es parseguen.El valor estàndard és Aspose.Cells.EmfRenderSetting.EmfOnly.Per als quadres que depenen de .Net System.Drawing.Common, aquesta configuració és ignorada.
EmfType
Obté o s’estableix un EmfType que especifica el format del Metafile..
public EmfType EmfType { get; set; }Valor de la propietat
GridlineType
Obtenir o establir el tipus de gridline.
public GridlineType GridlineType { get; set; }Valor de la propietat
Remarks
El tipus de defecte és determinat.
HorizontalResolution
Obté o fixa la resolució horitzontal per a les imatges generades, en punts per centímetre.
public int HorizontalResolution { get; set; }Valor de la propietat
Examples
El codi següent fixa la resolució a 192, l’amplada i l’altura de la imatge generada és el doble deL’únic amb resolució queda com el valor de default 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
El valor estàndard és 96.
Establir Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolució i Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolució afecta l’amplada i l’altura de la imatge de sortida en píxels.
ImageType
Obté o estableix el format de les imatges generades.Valoració de la funció: PNG.
public virtual ImageType ImageType { get; set; }Valor de la propietat
IsCellAutoFit
Indica si la amplada i l’altura de les cèl·lules s’ajusta automàticament per valor de la cel·la.El valor defectuós és fals.
[Obsolete("Use Worksheet.AutoFitColumns(AutoFitterOptions) and Worksheet.AutoFitRows(AutoFitterOptions) instead.")]
[Browsable(false)]
public bool IsCellAutoFit { get; set; }Valor de la propietat
Remarks
NOTA: Aquest membre és ara obsolet. en lloc,Si us plau, utilitzeu Aspose.Cells.Worksheet.AutoFitColumns(_W L 27.AutofitterOptions) i __ WL 27 _.Tributs de treball.Aquesta propietat es retirarà 12 mesos més tard des d’agost de 2022.Aspose s’excusa per qualsevol inconvenient que pugui haver experimentat.
IsFontSubstitutionCharGranularity
Indica si substituir la lletra de caràcter només quan la lletra de cèl·lula no és compatible amb ella.
public bool IsFontSubstitutionCharGranularity { get; set; }Valor de la propietat
Remarks
Provarem fonts predefinits de Workbook i PdfSaveOption/sistema per a fonts de cèl·lula primer.
IsOptimized
Indica si optimitzar els elements de producci.
public bool IsOptimized { get; set; }Valor de la propietat
Remarks
El valor defectuós és fals.Actualment, quan aquesta propietat s’estableix, es realitzaran les següents optimitzacions:
- Optimitzar les línies frontereres.
- Optimitzar la mida del fitxer mentre rendim a la imatge Svg.
OnePagePerSheet
Si OnePagePerSheet és veritable, tot el contingut d’una fila es produirà a només una pàgina en el resultat.La mida de paper de la pàgina serà invalidada, i les altres configuracions de la pàgina serà invalidada.Encara tindrà efecte.
public bool OnePagePerSheet { get; set; }Valor de la propietat
OnlyArea
Si aquesta propietat és veritable, una àrea serà producció, i cap escala tindrà efecte.
public bool OnlyArea { get; set; }Valor de la propietat
OutputBlankPageWhenNothingToPrint
Indica si es produeix una pàgina blanca quan no hi ha res per imprimir.
public bool OutputBlankPageWhenNothingToPrint { get; set; }Valor de la propietat
Remarks
El defecte és fals.
PageCount
Obté o estableix el nombre de pàgines per salvar.
public int PageCount { get; set; }Valor de la propietat
Remarks
Default és System.Int32.MaxValue que significa que totes les pàgines es rendiran.
PageIndex
Obté o posa l’índex basat en 0 de la primera pàgina per salvar.
public int PageIndex { get; set; }Valor de la propietat
Remarks
El defecte és 0.
PageSavingCallback
Control / Indica el progrés del procés d’emmagatzematge de pàgina.
public IPageSavingCallback PageSavingCallback { get; set; }Valor de la propietat
PixelFormat
Obté o estableix el format de píxels per a les imatges generades.
public PixelFormat PixelFormat { get; set; }Valor de la propietat
Remarks
El valor estàndard és PixelFormat.Format32bppArgb.
PrintWithStatusDialog
Si PrintWithStatusDialog = veritat, hi haurà un diàleg que mostra l’estat d’impressió actual.No hi haurà cap diàleg com aquest.
public bool PrintWithStatusDialog { get; set; }Valor de la propietat
PrintingPage
Indica quines pàgines no s’imprimiran.
public PrintingPageType PrintingPage { get; set; }Valor de la propietat
Quality
Obtenir o establir un valor que determina la qualitat de la imatge generada només s’aplica quan s’emmagatzemen pàgines al format ‘Jpeg’.
public int Quality { get; set; }Valor de la propietat
Remarks
Només s’efectua quan s’estalvi a JPEG.El valor ha de ser entre 0 i 100.El valor estàndard és 100.
Càlculs de visibilitat
si aquesta propietat és veritable, el SVG generat s’ajustarà a veure el port.
[Obsolete("Use SvgImageOptions.FitToViewPort property instead.")]
[Browsable(false)]
public bool SVGFitToViewPort { get; set; }Valor de la propietat
SaveFormat
Obtenir o configurar el tipus de format de fitxer de sortidaSuport Tiff/XPS
[Obsolete("For Tiff/Svg, use ImageType; For Xps, use Workbook.Save(string, SaveOptions) with XpsSaveOptions")]
[Browsable(false)]
public SaveFormat SaveFormat { get; set; }Valor de la propietat
Remarks
NOTA: Aquest membre és ara obsolet. en lloc,Per a Tiff/Svg, utilitzeu Aspose.Cells.Rendering.ImageOrPrintOptions. ImageType; per a Xps, feu servir __ WL27.Workbook.Save(System.String,_Wl27.SalvaOpcions) amb __VL37.XpsSalveOpciones.Aquesta propietat es retirarà 12 mesos més tard des d’agost de 2022.Aspose s’excusa per qualsevol inconvenient que pugui haver experimentat.
SheetSet
Default és totes les fulles visibles en el llibre de treball: Aspose.Cells.Rendering.SheetSet.Visible.
public SheetSet SheetSet { get; set; }Valor de la propietat
Remarks
El conjunt s’ignora quan s’utilitza en Aspose.Cells.Rendering.SheetRender
SmoothingMode
Especifica si s’aplica el suaviment (antialiatge) a les línies i les curves i els extrems de les àrees omplides.El valor estàndard és SmoothingMode.None
public SmoothingMode SmoothingMode { get; set; }Valor de la propietat
SvgCssPrefix
Obté i estableix el prefix del nom de css en svg,el valor estàndard és la barra buida.
[Obsolete("Use SvgImageOptions.CssPrefix property instead.")]
[Browsable(false)]
public string SvgCssPrefix { get; set; }Valor de la propietat
TextCrossType
Obté o s’estableix el tipus de text quan la amplada del text és més gran que la amplada de la cèl·lula.
public TextCrossType TextCrossType { get; set; }Valor de la propietat
TextRenderingHint
Especifica la qualitat de la renderització de text.El valor estàndard és TextRenderingHint.SystemDefault
public TextRenderingHint TextRenderingHint { get; set; }Valor de la propietat
TiffBinarizationMethod
Obtenir o configurar el mètode utilitzat en la conversió d’imatges en 1 format bppQuan Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType és Tiff i Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompressió és igual a Ccitt3 o Ccitt4.
public ImageBinarizationMethod TiffBinarizationMethod { get; set; }Valor de la propietat
Remarks
El valor estàndard és FloydSteinbergDithering.
TiffColorDepth
Obté o estableix bit profunditat per aplicar només quan salva pàgines al format ‘Tiff.
public ColorDepth TiffColorDepth { get; set; }Valor de la propietat
Remarks
Només té efecte quan estalvia a TIFF.Si TiffCompression s’estableix a CCITT3, CCITT4, això no tindrà efecte, la profunditat del bit de la imatge tiff generada serà sempre 1.
TiffCompression
Obté o estableix el tipus de compressió que només s’aplica quan salva pàgines al format ‘Tiff.
public TiffCompression TiffCompression { get; set; }Valor de la propietat
Remarks
Només té efecte quan estalvia a TIFF.El valor estàndard és Lzw.
Transparent
Indica si el fons de la imatge generada ha de ser transparent.
public bool Transparent { get; set; }Valor de la propietat
Remarks
El valor estàndard és fals. Això significa que el fons de les imatges generades és blanc.
VerticalResolution
Obté o estableix la resolució vertical per a les imatges generades, en punts per polz.
public int VerticalResolution { get; set; }Valor de la propietat
Examples
El codi següent fixa la resolució a 192, l’amplada i l’altura de la imatge generada és el doble deL’únic amb resolució queda com el valor de default 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
El valor estàndard és 96.
Establir Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolució i Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolució afecta l’amplada i l’altura de la imatge de sortida en píxels.
WarningCallback
Obtenir o establir un avís de tornada.
public IWarningCallback WarningCallback { get; set; }Valor de la propietat
Methods
SetDesiredSize(Int, Int)
Estableix l’amplada i l’alçada desitjada de la imatge.
[Obsolete("Use SetDesiredSize(int, int, bool) by setting param keepAspectRatio to false instead.")]
public void SetDesiredSize(int desiredWidth, int desiredHeight)Parameters
desiredWidth int
Amplitud desitjada en píxels
desiredHeight int
Alçada desitjada en píxels
Remarks
NOTA: Aquest membre és ara obsolet. en lloc,Si us plau utilitzeu Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) mitjançant l’establiment de paràmetre manté l’AspectRatio en fals.Aquesta propietat es retirarà 12 mesos més tard des de maig de 2023.Aspose s’excusa per qualsevol inconvenient que pugui haver experimentat.
SetDesiredSize(Int, int i bool)
Estableix l’amplada i l’alçada desitjada de la imatge.
public void SetDesiredSize(int desiredWidth, int desiredHeight, bool keepAspectRatio)Parameters
desiredWidth int
Amplitud desitjada en píxels
desiredHeight int
Alçada desitjada en píxels
keepAspectRatio bool
Si cal mantenir la proporció d’aspecte de la imatge d’origen
Remarks
L’amplada i l’alçada de la imatge de sortida en píxels només es basarà en l’amplada i l’alçada desitjats.
Els Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolució i Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolució no afectarà l’amplada i l’altura de la imatge de sortida en aquest cas.
