Class ImageOrPrintOptions
Nombre del espacio: Aspose.Cells.Rendering Asamblea: Aspose.Cells.dll (25.4.0)
Permite especificar opciones al renderizar la hoja de trabajo a imágenes, imprimir la hoja de trabajo o renderizar el gráfico a imagen.
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 es cierto, todo el contenido de la columna de una hoja saldrá a una sola página como resultado.La anchura del tamaño de papel de la página será invalida, y las demás configuraciones de la página será invalida.Y seguirá teniendo efecto.
public bool AllColumnsInOnePagePerSheet { get; set; }Valor de la propiedad
ChartImageType
Indicar el tipo de imagen del gráfico al convertir.Valor de defecto: 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 propiedad
Remarks
NOTA: Este miembro es ahora obsoleto,El gráfico y la forma son siempre renderizados como elementos vectores (por ejemplo, punto, línea) para renderizar la calidad.Esta propiedad se retirará 12 meses más tarde desde junio de 2022.Aspose se disculpa por cualquier inconveniente que pueda haber experimentado.
CheckWorkbookDefaultFont
Cuando los caracteres en Excel son Unicode y no se establecen con la letra correcta en estilo celular,Pueden aparecer como bloques en pdf, imagen.Configure esto para tratar de usar la letra predeterminada del libro de trabajo para mostrar estos caracteres primero.
public bool CheckWorkbookDefaultFont { get; set; }Valor de la propiedad
Remarks
El defecto es verdadero.
CustomPrintPageEventHandler
El cliente puede imprimir una salida especial al imprimir cada página utilizando este EventHandler.
public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }Valor de la propiedad
CustomQueryPageSettingsEventHandler
El cliente puede controlar la configuración de página de la impresora al imprimir cada página utilizando este EventHandler
public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }Valor de la propiedad
DefaultEditLanguage
Obtén o establezca el lenguaje de edición por defecto.
public DefaultEditLanguage DefaultEditLanguage { get; set; }Valor de la propiedad
Remarks
Puede mostrar/render diferentes layouts para el parágrafo de texto cuando se establecen diferentes lenguas de edición.Default es Aspose.Cells.DefaultEditLanguage.Auto.
DefaultFont
Cuando los caracteres en Excel son Unicode y no se establecen con la letra correcta en estilo celular,Pueden aparecer como bloques en pdf, imagen.Configure el DefaultFont como MingLiu o MS Gothic para mostrar estos personajes.Si esta propiedad no está configurada, Aspose.Cells utilizará la font de sistema para mostrar estos caracteres de unicode.
public string DefaultFont { get; set; }Valor de la propiedad
DrawObjectEventHandler
Implementa esta interfaz para obtener DrawObject y Bound al renderizar.
public DrawObjectEventHandler DrawObjectEventHandler { get; set; }Valor de la propiedad
EmbededImageNameInSvg
Indicar el nombre de la imagen incorporada en svg.Este debe ser el camino completo con directorios como “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 propiedad
EmfRenderSetting
Configuración para renderizar metáfilos EMF en el archivo de fuente.
public EmfRenderSetting EmfRenderSetting { get; set; }Valor de la propiedad
Remarks
Los metáfilos EMF identificados como “EMF+ Dual” pueden contener tanto los registros EMF+ como los registros EMF.Se puede utilizar cualquier tipo de registro para render la imagen, sólo los registros EMF+ o sólo los registros EMF.Cuando se establezca Aspose.Cells.EmfRenderSetting.EmfPlusPrefer, entonces los registros EMF+ serán parsed mientras se renden a la imagen, de lo contrario sólo los registros EMF serán parsed.El valor estándar es Aspose.Cells.EmfRenderSetting.EmfOnly.Para los marco que dependen de .Net System.Drawing.Common, esta configuración se ignora.
EmfType
Obtenga o establece un EmfType que especifica el formato del Metafile..
public EmfType EmfType { get; set; }Valor de la propiedad
GridlineType
Obtenga o establece el tipo de gridline.
public GridlineType GridlineType { get; set; }Valor de la propiedad
Remarks
Default es el tipo Dotted.
HorizontalResolution
Obtenga o establece la resolución horizontal para las imágenes generadas, en puntos por pulgón.
public int HorizontalResolution { get; set; }Valor de la propiedad
Examples
El siguiente código establece la resolución a 192, la anchura y la altura de la imagen generada es el doble deel que tiene resolución se deja como el valor estándar 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ándar es 96.
Establecimiento Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution y Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution efectúa la anchura y altura de la imagen de salida en píxeles.
ImageType
Obtenga o establece el formato de las imágenes generadas.Valor de defecto: PNG.
public virtual ImageType ImageType { get; set; }Valor de la propiedad
IsCellAutoFit
Indica si la anchura y la altura de las células se ajustan automáticamente por valor celular.El valor defectuoso es falso.
[Obsolete("Use Worksheet.AutoFitColumns(AutoFitterOptions) and Worksheet.AutoFitRows(AutoFitterOptions) instead.")]
[Browsable(false)]
public bool IsCellAutoFit { get; set; }Valor de la propiedad
Remarks
NOTA: Este miembro es ahora obsoleto,Por favor, utilice Aspose.Cells.Worksheet.AutoFitColumns(_W L 27.AutofitterOptions) y __ WL 27 _.Trabajos de trabajo.Esta propiedad se retirará 12 meses más tarde desde agosto de 2022.Aspose se disculpa por cualquier inconveniente que pueda haber experimentado.
IsFontSubstitutionCharGranularity
Indica si sólo sustituir la letra de carácter cuando la letra celular no es compatible con ella.
public bool IsFontSubstitutionCharGranularity { get; set; }Valor de la propiedad
Remarks
Vamos a probar la letra predefinida de Workbook y PdfSaveOption/sistema para la letra celular primero.
IsOptimized
Indica si optimizar los elementos de producción.
public bool IsOptimized { get; set; }Valor de la propiedad
Remarks
El valor defectuoso es falso.Actualmente, cuando esta propiedad se establezca en realidad, se harán las siguientes optimizaciones:
- Optimización de las líneas fronterizas.
- optimizar el tamaño del archivo mientras se rendirá a la imagen Svg.
OnePagePerSheet
Si OnePagePerSheet es verdadero, todo el contenido de una hoja saldrá a una sola página como resultado.El tamaño de papel de la página será invalida, y las demás configuraciones de la página será invalida.Y seguirá teniendo efecto.
public bool OnePagePerSheet { get; set; }Valor de la propiedad
OnlyArea
Si esta propiedad es verdadera, una Área será producción, y ninguna escala entrará en vigor.
public bool OnlyArea { get; set; }Valor de la propiedad
OutputBlankPageWhenNothingToPrint
Indica si se debe producir una página blanca cuando no hay nada que imprimir.
public bool OutputBlankPageWhenNothingToPrint { get; set; }Valor de la propiedad
Remarks
El defecto es falso.
PageCount
Obtenga o establece el número de páginas para guardar.
public int PageCount { get; set; }Valor de la propiedad
Remarks
Default es System.Int32.MaxValue que significa que todas las páginas serán renderizadas.
PageIndex
Obtenga o establece el índice basado en 0 de la primera página para guardar.
public int PageIndex { get; set; }Valor de la propiedad
Remarks
El defecto es 0.
PageSavingCallback
Control/Indicar el progreso del proceso de almacenamiento de páginas.
public IPageSavingCallback PageSavingCallback { get; set; }Valor de la propiedad
PixelFormat
Obtenga o establece el formato de píxeles para las imágenes generadas.
public PixelFormat PixelFormat { get; set; }Valor de la propiedad
Remarks
El valor estándar es PixelFormat.Format32bppArgb.
PrintWithStatusDialog
Si PrintWithStatusDialog = verdad, habrá un diálogo que muestra el estado de impresión actual.De lo contrario, no habrá diálogo as.
public bool PrintWithStatusDialog { get; set; }Valor de la propiedad
PrintingPage
Indica qué páginas no se imprimirán.
public PrintingPageType PrintingPage { get; set; }Valor de la propiedad
Quality
Recibe o establece un valor que determina la calidad del imagesto generado sólo se aplica cuando se ahorran páginas en el formato ‘Jpeg’.
public int Quality { get; set; }Valor de la propiedad
Remarks
Sólo funciona cuando se ahorra en JPEG.El valor debe estar entre 0 y 100.El valor de default es 100.
SiguienteViewPort
si esta propiedad es verdadera, el SVG generado será adecuado para ver el puerto.
[Obsolete("Use SvgImageOptions.FitToViewPort property instead.")]
[Browsable(false)]
public bool SVGFitToViewPort { get; set; }Valor de la propiedad
SaveFormat
Obtenga o establece el tipo de formato de archivo de salidaSoporte 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 propiedad
Remarks
NOTA: Este miembro es ahora obsoleto,Para Tiff/Svg, use Aspose.Cells.Rendering.ImageOrPrintOptions.ImajeType; Para Xps, utilice Wl27.Workbook.Save(System.String,W L 27 .SaverOpciones) con __ WL27.Esta propiedad se retirará 12 meses más tarde desde agosto de 2022.Aspose se disculpa por cualquier inconveniente que pueda haber experimentado.
SheetSet
Default es todas las hojas visibles en el libro de trabajo: Aspose.Cells.Rendering.SheetSet.Visible.
public SheetSet SheetSet { get; set; }Valor de la propiedad
Remarks
El conjunto se ignora cuando se utiliza en Aspose.Cells.Rendering.SheetRender
SmoothingMode
Especifica si se aplica suavidad (antialias) a las líneas y curvas y los lados de las áreas llenas.El valor estándar es SmoothingMode.None
public SmoothingMode SmoothingMode { get; set; }Valor de la propiedad
SvgCssPrefix
Obtén y establece el prefixo del nombre de css en svg,el valor predeterminado es una línea vacía.
[Obsolete("Use SvgImageOptions.CssPrefix property instead.")]
[Browsable(false)]
public string SvgCssPrefix { get; set; }Valor de la propiedad
TextCrossType
Obtenga o establece el tipo de texto cuando la anchura del texto es más grande que la anchura de la célula.
public TextCrossType TextCrossType { get; set; }Valor de la propiedad
TextRenderingHint
Especifica la calidad de la renderización de texto.El valor estándar es TextRenderingHint.SystemDefault
public TextRenderingHint TextRenderingHint { get; set; }Valor de la propiedad
TiffBinarizationMethod
Obtener o establecer el método utilizado al convertir imágenes en 1 bppCuando Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType es Tiff y Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompression es igual a Ccitt3 o Ccitt4.
public ImageBinarizationMethod TiffBinarizationMethod { get; set; }Valor de la propiedad
Remarks
El valor estándar es FloydSteinbergDithering.
TiffColorDepth
Obtenga o establece un bit de profundidad para aplicar sólo cuando salve páginas en el formato ‘Tiff.
public ColorDepth TiffColorDepth { get; set; }Valor de la propiedad
Remarks
Sólo funciona cuando se ahorra a TIFF.Si TiffCompression se establece en CCITT3, CCITT4, esto no va a tener efecto, la profundidad del bit de la imagen tiff generada será siempre 1.
TiffCompression
Obtenga o establece el tipo de compresión para aplicar sólo cuando salve páginas en el formato ‘Tiff.
public TiffCompression TiffCompression { get; set; }Valor de la propiedad
Remarks
Sólo funciona cuando se ahorra a TIFF.El valor estándar es Lzw.
Transparent
Indica si el fondo de la imagen generada debe ser transparente.
public bool Transparent { get; set; }Valor de la propiedad
Remarks
El valor estándar es falso, lo que significa que el fondo de las imágenes generadas es blanco.
VerticalResolution
Obtenga o establece la resolución vertical para las imágenes generadas, en puntos por pulgón.
public int VerticalResolution { get; set; }Valor de la propiedad
Examples
El siguiente código establece la resolución a 192, la anchura y la altura de la imagen generada es el doble deel que tiene resolución se deja como el valor estándar 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ándar es 96.
Establecimiento Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution y Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution efectúa la anchura y altura de la imagen de salida en píxeles.
WarningCallback
Recibe o establece un alerta de llamamiento.
public IWarningCallback WarningCallback { get; set; }Valor de la propiedad
Methods
SetDesiredSize(El int, int)
Establece la anchura y altura deseada de la imagen.
[Obsolete("Use SetDesiredSize(int, int, bool) by setting param keepAspectRatio to false instead.")]
public void SetDesiredSize(int desiredWidth, int desiredHeight)Parameters
desiredWidth int
Amplía deseada en píxeles
desiredHeight int
La altura deseada en píxeles
Remarks
NOTA: Este miembro es ahora obsoleto,Por favor, utilice Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) al configurar el parámetro para mantener a AspectRatio falso.Esta propiedad se retirará 12 meses más tarde desde mayo de 2023.Aspose se disculpa por cualquier inconveniente que pueda haber experimentado.
SetDesiredSize(int, int, bool)
Establece la anchura y altura deseada de la imagen.
public void SetDesiredSize(int desiredWidth, int desiredHeight, bool keepAspectRatio)Parameters
desiredWidth int
Amplía deseada en píxeles
desiredHeight int
La altura deseada en píxeles
keepAspectRatio bool
Cómo mantener la relación de aspecto de la imagen de origen
Remarks
La anchura y altura de la imagen de salida en píxeles sólo se basará en la anchura y altura deseada.
El Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution y Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution no afectará a la anchura y altura de la imagen de salida en este caso.
