Class ImageOrPrintOptions
Nome do espaço: Aspose.Cells.Rendering Assembleia: Aspose.Cells.dll (25.4.0)
Permite especificar opções quando renderar folhas de trabalho para imagens, imprimir folhas de trabalho ou renderar gráficos para imagens.
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()
O Ctor.
public ImageOrPrintOptions()Properties
AllColumnsInOnePagePerSheet
Se o AllColumnsInOnePagePerSheet for verdadeiro, todos os conteúdos de coluna de uma folha irão sair para apenas uma página no resultado.A largura do tamanho do papel do setup de páginas será invalida, e as outras configurações do setup de páginascontinuará a ter efeito.
public bool AllColumnsInOnePagePerSheet { get; set; }Valor da propriedade
ChartImageType
Indica o tipo de imagem do gráfico ao converter.Valor padrão: 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 da propriedade
Remarks
Nota: Este membro é agora obsoleto. em vez disso,O gráfico e a forma são sempre renderizados como elementos vectores (por exemplo, ponto, linha) para renderização de qualidade.Esta propriedade será removida 12 meses depois a partir de junho de 2022.Aspose se desculpa por qualquer desconforto que você possa ter experimentado.
CheckWorkbookDefaultFont
Quando os caracteres no Excel são Unicode e não estão configurados com a letra correta em estilo celular,Eles podem aparecer como blocos em pdf, imagem.Configure isso para ser verdadeiro para tentar usar a letra padrão do livro de trabalho para exibir estes caracteres primeiro.
public bool CheckWorkbookDefaultFont { get; set; }Valor da propriedade
Remarks
O defeito é verdadeiro.
CustomPrintPageEventHandler
O cliente pode obter uma saída especial para a impressora quando imprima cada página usando este EventHandler
public PrintPageEventHandler CustomPrintPageEventHandler { get; set; }Valor da propriedade
CustomQueryPageSettingsEventHandler
O cliente pode controlar a configuração da página da impressora ao imprimir cada página usando este EventHandler
public QueryPageSettingsEventHandler CustomQueryPageSettingsEventHandler { get; set; }Valor da propriedade
DefaultEditLanguage
Obter ou configurar o idioma de edição padrão.
public DefaultEditLanguage DefaultEditLanguage { get; set; }Valor da propriedade
Remarks
Pode exibir/render diferentes layouts para parágrafo de texto quando diferentes idiomas de edição são definidos.O padrão é Aspose.Cells.DefaultEditLanguage.Auto.
DefaultFont
Quando os caracteres no Excel são Unicode e não estão configurados com a letra correta em estilo celular,Eles podem aparecer como blocos em pdf, imagem.Configure o DefaultFont como MingLiu ou MS Gothic para exibir esses personagens.Se esta propriedade não for configurada, a Aspose.Cells usará a fonte padrão do sistema para exibir esses caracteres unicode.
public string DefaultFont { get; set; }Valor da propriedade
DrawObjectEventHandler
Implemente esta interface para obter DrawObject e Bound ao renderizar.
public DrawObjectEventHandler DrawObjectEventHandler { get; set; }Valor da propriedade
EmbededImageNameInSvg
Indica o nome da imagem incorporada em svg.Este deve ser o caminho completo com diretórios 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 da propriedade
EmfRenderSetting
Configuração para renderizar metáfilos EMF em arquivo de origem.
public EmfRenderSetting EmfRenderSetting { get; set; }Valor da propriedade
Remarks
Os metáfilos EMF identificados como “EMF+ Dual” podem conter tanto os registros EMF+ quanto os registros EMF.Qualquer tipo de registro pode ser usado para render a imagem, apenas registros EMF+ ou apenas registros EMF.Quando o Aspose.Cells.EmfRenderSetting.EmfPlusPrefer é configurado, em seguida, os registros EMF+ serão parsed enquanto se render à imagem, caso contrário, apenas os registros EMF serão parsed.O valor padrão é Aspose.Cells.EmfRenderSetting.EmfOnly.Para os quadros que dependem do .Net System.Drawing.Common, esta configuração é ignorada.
EmfType
Obter ou definir um EmfType que especifica o formato do Metafile.
public EmfType EmfType { get; set; }Valor da propriedade
GridlineType
Obter ou definir o tipo de gridline.
public GridlineType GridlineType { get; set; }Valor da propriedade
Remarks
O padrão é o tipo Dotted.
HorizontalResolution
Obter ou definir a resolução horizontal para imagens geradas, em pontos por polegada.
public int HorizontalResolution { get; set; }Valor da propriedade
Examples
O código a seguir coloca a resolução para 192, a largura e altura da imagem gerada são duas vezes mais do queO valor com resolução ficou como o valor padrão 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
O valor padrão é 96.
Configuração Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution e Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution afeta a largura e altura da imagem de saída em pixels.
ImageType
Obter ou definir o formato das imagens geradas.Valor padrão: PNG.
public virtual ImageType ImageType { get; set; }Valor da propriedade
IsCellAutoFit
Indica se a largura e altura das células são automaticamente ajustadas por valor celular.O valor padrão é falso.
[Obsolete("Use Worksheet.AutoFitColumns(AutoFitterOptions) and Worksheet.AutoFitRows(AutoFitterOptions) instead.")]
[Browsable(false)]
public bool IsCellAutoFit { get; set; }Valor da propriedade
Remarks
Nota: Este membro é agora obsoleto. em vez disso,Por favor, use Aspose.Cells.Worksheet.AutoFitColumns(_W L 27.OutofitterOptions) e __ WL 27 _.Tempo de trabalho.Esta propriedade será removida 12 meses mais tarde a partir de agosto de 2022.Aspose se desculpa por qualquer desconforto que você possa ter experimentado.
IsFontSubstitutionCharGranularity
Indica se substituir a letra de caráter apenas quando a letra celular não é compatível com ela.
public bool IsFontSubstitutionCharGranularity { get; set; }Valor da propriedade
Remarks
Vamos tentar a letra padrão do Workbook e PdfSaveOption/system para a letra celular primeiro.
IsOptimized
Indica se para otimizar os elementos de output.
public bool IsOptimized { get; set; }Valor da propriedade
Remarks
O valor padrão é falso.Atualmente, quando esta propriedade é definida como verdadeira, as seguintes otimizações serão feitas:
- otimização das linhas de fronteira.
- Otimize o tamanho do arquivo ao render para a imagem Svg.
OnePagePerSheet
Se o OnePagePerSheet for verdadeiro, todos os conteúdos de uma folha irão sair para apenas uma página no resultado.O tamanho de papel do setup de páginas será inválido, e as outras configurações do setup de páginascontinuará a ter efeito.
public bool OnePagePerSheet { get; set; }Valor da propriedade
OnlyArea
Se esta propriedade for verdadeira, uma Área será a saída e nenhuma escala entrará em vigor.
public bool OnlyArea { get; set; }Valor da propriedade
OutputBlankPageWhenNothingToPrint
Indica se você deve produzir uma página branca quando não há nada para imprimir.
public bool OutputBlankPageWhenNothingToPrint { get; set; }Valor da propriedade
Remarks
Definição é falsa.
PageCount
Obter ou definir o número de páginas para salvar.
public int PageCount { get; set; }Valor da propriedade
Remarks
O padrão é System.Int32.MaxValue, o que significa que todas as páginas serão renderizadas.
PageIndex
Obter ou definir o índice baseado em 0 da primeira página para salvar.
public int PageIndex { get; set; }Valor da propriedade
Remarks
O padrão é 0.
PageSavingCallback
Controlar/Indicar o progresso do processo de armazenamento de página.
public IPageSavingCallback PageSavingCallback { get; set; }Valor da propriedade
PixelFormat
Obter ou definir o formato de pixel para as imagens geradas.
public PixelFormat PixelFormat { get; set; }Valor da propriedade
Remarks
O valor padrão é PixelFormat.Format32bppArgb.
PrintWithStatusDialog
Se PrintWithStatusDialog = verdade, haverá um diálogo que mostra o estado atual da impressão.Caso contrário, tal diálogo não será mostrado.
public bool PrintWithStatusDialog { get; set; }Valor da propriedade
PrintingPage
Indica quais páginas não serão impressas.
public PrintingPageType PrintingPage { get; set; }Valor da propriedade
Quality
Obter ou definir um valor que determina a qualidade do imagesto gerado só se aplica quando as páginas são salvas no formato ‘Jpeg’.
public int Quality { get; set; }Valor da propriedade
Remarks
Ele só funciona quando você economiza em JPEG.O valor deve ser entre 0 e 100.O valor padrão é 100.
Título: SVGFitToViewPort
Se esta propriedade for verdadeira, o SVG gerado será adequado para ver o porto.
[Obsolete("Use SvgImageOptions.FitToViewPort property instead.")]
[Browsable(false)]
public bool SVGFitToViewPort { get; set; }Valor da propriedade
SaveFormat
Obter ou definir o tipo de formato de arquivo de saídaSuporte para 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 da propriedade
Remarks
Nota: Este membro é agora obsoleto. em vez disso,Para Tiff/Svg, use Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType; Para Xps, utilize Wl27.Workbook.Save(System.String,W L 27 .SaverOpções) com _ WL27.Esta propriedade será removida 12 meses mais tarde a partir de agosto de 2022.Aspose se desculpa por qualquer desconforto que você possa ter experimentado.
SheetSet
Default é todas as folhas visíveis no livro de trabalho: Aspose.Cells.Rendering.SheetSet.Visible.
public SheetSet SheetSet { get; set; }Valor da propriedade
Remarks
O conjunto é ignorado quando é usado em Aspose.Cells.Rendering.SheetRender
SmoothingMode
Determina se a suavidade (antialiasing) é aplicada a linhas e curvas e os lados das áreas preenchidas.O valor padrão é SmoothingMode.None
public SmoothingMode SmoothingMode { get; set; }Valor da propriedade
SvgCssPrefix
Obter e definir o prefixo do nome do css em svg, o valor padrão é a linha vazia.
[Obsolete("Use SvgImageOptions.CssPrefix property instead.")]
[Browsable(false)]
public string SvgCssPrefix { get; set; }Valor da propriedade
TextCrossType
Obter ou definir o tipo de texto quando a largura do texto é maior do que a largura da célula.
public TextCrossType TextCrossType { get; set; }Valor da propriedade
TextRenderingHint
Determina a qualidade da renderização de texto.O valor padrão é TextRenderingHint.SystemDefault
public TextRenderingHint TextRenderingHint { get; set; }Valor da propriedade
TiffBinarizationMethod
Obter ou configurar o método usado ao converter imagens em 1 bpp formatoQuando Aspose.Cells.Rendering.ImageOrPrintOptions.ImageType é Tiff e Aspose.Cells.Rendering.ImageOrPrintOptions.TiffCompression é igual a Ccitt3 ou Ccitt4.
public ImageBinarizationMethod TiffBinarizationMethod { get; set; }Valor da propriedade
Remarks
O valor padrão é FloydSteinbergDithering.
TiffColorDepth
Obter ou definir um bit de profundidade para aplicar apenas quando salvar páginas no formato ‘Tiff’.
public ColorDepth TiffColorDepth { get; set; }Valor da propriedade
Remarks
Ele só funciona quando economizar para o TIFF.Se a TiffCompression for configurada para CCITT3, CCITT4, isso não entrará em vigor, a profundidade do bit da imagem tiff gerada será sempre 1.
TiffCompression
Obter ou definir o tipo de compressão para aplicar apenas quando salvar páginas no formato ‘Tiff’.
public TiffCompression TiffCompression { get; set; }Valor da propriedade
Remarks
Ele só funciona quando economizar para o TIFF.O valor padrão é Lzw.
Transparent
Indica se o fundo da imagem gerada deve ser transparente.
public bool Transparent { get; set; }Valor da propriedade
Remarks
O valor padrão é falso, o que significa que o fundo das imagens geradas é branco.
VerticalResolution
Obter ou definir a resolução vertical para imagens geradas, em pontos por polegada.
public int VerticalResolution { get; set; }Valor da propriedade
Examples
O código a seguir coloca a resolução para 192, a largura e altura da imagem gerada são duas vezes mais do queO valor com resolução ficou como o valor padrão 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
O valor padrão é 96.
Configuração Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution e Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution afeta a largura e altura da imagem de saída em pixels.
WarningCallback
Receba ou coloca um alerta de volta.
public IWarningCallback WarningCallback { get; set; }Valor da propriedade
Methods
SetDesiredSize(Int, Int)
Selecione a largura e altura desejada da imagem.
[Obsolete("Use SetDesiredSize(int, int, bool) by setting param keepAspectRatio to false instead.")]
public void SetDesiredSize(int desiredWidth, int desiredHeight)Parameters
desiredWidth int
A largura desejada em pixels
desiredHeight int
altura desejada em pixels
Remarks
Nota: Este membro é agora obsoleto. em vez disso,Por favor, use Aspose.Cells.Rendering.ImageOrPrintOptions.SetDesiredSize(System.Int32,System.Int32,System.Boolean) configurando o parâmetro para manterAspectRatio falso.Esta propriedade será removida 12 meses mais tarde a partir de maio de 2023.Aspose se desculpa por qualquer desconforto que você possa ter experimentado.
SetDesiredSize(Int, Int e Bool)
Selecione a largura e altura desejada da imagem.
public void SetDesiredSize(int desiredWidth, int desiredHeight, bool keepAspectRatio)Parameters
desiredWidth int
A largura desejada em pixels
desiredHeight int
altura desejada em pixels
keepAspectRatio bool
Como manter o aspecto da imagem de origem
Remarks
A largura e altura da imagem de saída em pixels só será baseada na largura e altura desejadas.
O Aspose.Cells.Rendering.ImageOrPrintOptions.HorizontalResolution e Aspose.Cells.Rendering.ImageOrPrintOptions.VerticalResolution não afetará a largura e altura da imagem de saída neste caso.
