Class Chart
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Encapsula o objeto que representa um único gráfico do Excel.
public class ChartHerança
Membros Herdados
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Exemplos
Os códigos a seguir mostram como criar um gráfico com códigos .Net.
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
Cells cells = sheet.Cells;
cells[0,1].PutValue("Renda");
cells[1,0].PutValue("Empresa A");
cells[2,0].PutValue("Empresa B");
cells[3,0].PutValue("Empresa C");
cells[1,1].PutValue(10000);
cells[2,1].PutValue(20000);
cells[3,1].PutValue(30000);
int chartIndex = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15);
Chart chart = sheet.Charts[chartIndex];
chart.SetChartDataRange("A1:B4", true);
chart.ShowLegend = true;
chart.Title.Text = "Análise de Renda";Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)
Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("Renda")
cells(1,0).PutValue("Empresa A")
cells(2,0).PutValue("Empresa B")
cells(3,0).PutValue("Empresa C")
cells(1,1).PutValue(10000)
cells(2,1).PutValue(20000)
cells(3,1).PutValue(30000)
Dim chartIndex as Integer = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15)
Dim chart as Chart = sheet.Charts(chartIndex)
chart.SetChartDataRange("A1:B4", True);
chart.ShowLegend = True
chart.Title.Text = "Análise de Renda"Propriedades
ActualChartSize
Obtém o tamanho real do gráfico em unidades de pixels.
[Obsolete("Use Chart.GetActualSize() method instead.")]
public Size ActualChartSize { get; }Valor da Propriedade
Observações
NOTA: Este membro agora está obsoleto. Em vez disso, utilize o método Chart.GetActualSize(). Esta propriedade será removida 12 meses após julho de 2022. A Aspose se desculpa por qualquer inconveniente que você possa ter experimentado.
AutoScaling
Verdadeiro se o Microsoft Excel escala um gráfico 3-D para que ele fique mais próximo em tamanho do gráfico 2-D equivalente. A propriedade RightAngleAxes deve ser verdadeira.
public bool AutoScaling { get; set; }Valor da Propriedade
BackWall
Retorna um objeto Aspose.Cells.Charts.Chart.Walls que representa a parede de fundo de um gráfico 3-D.
public Walls BackWall { get; }Valor da Propriedade
CategoryAxis
Obtém o eixo X do gráfico.
public Axis CategoryAxis { get; }Valor da Propriedade
ChartArea
Obtém a área do gráfico na planilha.
public ChartArea ChartArea { get; }Valor da Propriedade
ChartDataTable
Representa a tabela de dados do gráfico.
public ChartDataTable ChartDataTable { get; }Valor da Propriedade
ChartObject
Representa o gráficoShape;
public ChartShape ChartObject { get; }Valor da Propriedade
DepthPercent
Representa a profundidade de um gráfico 3-D como uma porcentagem da largura do gráfico (entre 20 e 2000 por cento).
public int DepthPercent { get; set; }Valor da Propriedade
DisplayNaAsBlank
Indica se exibe #N/A como valor em branco.
public bool DisplayNaAsBlank { get; set; }Valor da Propriedade
Elevation
Representa a elevação da vista do gráfico 3-D, em graus.
public int Elevation { get; set; }Valor da Propriedade
Observações
A elevação do gráfico é a altura a que você visualiza o gráfico, em graus. O padrão é 15 para a maioria dos tipos de gráficos. O valor desta propriedade deve estar entre -90 e 90, exceto para gráficos de barras 3-D, onde deve estar entre 0 e 44.
FilteredNSeries
Obtém uma coleção Aspose.Cells.Charts.SeriesCollection representando as séries de dados que estão filtradas no gráfico.
public SeriesCollection FilteredNSeries { get; }Valor da Propriedade
FirstSliceAngle
Obtém ou define o ângulo da primeira fatia de gráfico de pizza ou gráfico de rosquinha, em graus (no sentido horário a partir da vertical). Aplica-se apenas a gráficos de pizza, pizza 3-D e gráficos de rosquinha, 0 a 360.
public int FirstSliceAngle { get; set; }Valor da Propriedade
Floor
Retorna um objeto Aspose.Cells.Charts.Chart.Floor que representa as paredes de um gráfico 3-D.
public Floor Floor { get; }Valor da Propriedade
Observações
Esta propriedade não se aplica a gráficos de pizza 3-D.
GapDepth
Obtém ou define a distância entre as séries de dados em um gráfico 3-D, como uma porcentagem da largura do marcador. O valor desta propriedade deve estar entre 0 e 500.
public int GapDepth { get; set; }Valor da Propriedade
GapWidth
Retorna ou define o espaço entre os grupos de barras ou colunas, como uma porcentagem da largura da barra ou coluna. O valor desta propriedade deve estar entre 0 e 500.
public int GapWidth { get; set; }Valor da Propriedade
HeightPercent
Retorna ou define a altura de um gráfico 3-D como uma porcentagem da largura do gráfico (entre 5 e 500 por cento).
public int HeightPercent { get; set; }Valor da Propriedade
HidePivotFieldButtons
Indica se oculta os botões de campo do gráfico dinâmico apenas quando o gráfico é um PivotChart.
public bool HidePivotFieldButtons { get; set; }Valor da Propriedade
Is3D
Indica se o gráfico é um gráfico 3D.
public bool Is3D { get; }Valor da Propriedade
IsRectangularCornered
Obtém ou define um valor indicando se a área do gráfico tem cantos retangulares. O padrão é verdadeiro.
public bool IsRectangularCornered { get; set; }Valor da Propriedade
Legend
Obtém a legenda do gráfico.
public Legend Legend { get; }Valor da Propriedade
Line
Obtém a linha.
public Line Line { get; }Valor da Propriedade
NSeries
Obtém uma coleção Aspose.Cells.Charts.SeriesCollection representando as séries de dados no gráfico.
public SeriesCollection NSeries { get; }Valor da Propriedade
Name
Obtém e define o nome do gráfico.
public string Name { get; set; }Valor da Propriedade
PageSetup
Representa a descrição da configuração da página neste gráfico.
public PageSetup PageSetup { get; }Valor da Propriedade
Perspective
Retorna ou define a perspectiva para a visualização do gráfico 3-D. Deve estar entre 0 e 100. Esta propriedade é ignorada se a propriedade RightAngleAxes for verdadeira.
public short Perspective { get; set; }Valor da Propriedade
PivotOptions
Especifica os controles de pivô que aparecem no gráfico.
public PivotOptions PivotOptions { get; }Valor da Propriedade
PivotSource
A fonte é os dados da tabela dinâmica. Se PivotSource não estiver vazio, o gráfico é um PivotChart.
public string PivotSource { get; set; }Valor da Propriedade
Observações
Se a tabela dinâmica “PivotTable1” na Planilha “Sheet1” no arquivo “Book1.xls”. A pivotSource poderia ser “[Book1.xls]Sheet1!PivotTable1” se o gráfico e a Tabela Dinâmica não estiverem no mesmo livro de trabalho. Se você definir esta propriedade, a configuração da fonte de dados anterior será perdida.
Placement
Representa a maneira como o gráfico está anexado às células abaixo dele.
public PlacementType Placement { get; set; }Valor da Propriedade
PlotArea
Obtém a área de plotagem do gráfico, que inclui rótulos de marcação do eixo.
public PlotArea PlotArea { get; }Valor da Propriedade
PlotBy
Obtém e define se a plotagem é feita por linha ou coluna.
public PlotDataByType PlotBy { get; }Valor da Propriedade
PlotEmptyCellsType
Obtém e define como plotar as células vazias.
public PlotEmptyCellsType PlotEmptyCellsType { get; set; }Valor da Propriedade
PlotVisibleCellsOnly
Indica se plota apenas células visíveis.
public bool PlotVisibleCellsOnly { get; set; }Valor da Propriedade
PrintSize
Obtém e define o tamanho do gráfico impresso.
public PrintSizeType PrintSize { get; set; }Valor da Propriedade
RightAngleAxes
Verdadeiro se os eixos do gráfico estiverem em ângulos retos. Aplica-se apenas a gráficos 3-D (exceto Gráficos de Coluna 3D e Gráficos de Pizza 3-D).
public bool RightAngleAxes { get; set; }Valor da Propriedade
Observações
Se esta propriedade for verdadeira, a propriedade Perspective será ignorada.
RotationAngle
Representa a rotação da visualização do gráfico 3-D (a rotação da área de plotagem em torno do eixo z, em graus).
public int RotationAngle { get; set; }Valor da Propriedade
Observações
O valor desta propriedade deve estar entre 0 e 360, exceto para gráficos de barras 3-D, onde o valor deve estar entre 0 e 44. O valor padrão é 20. Aplica-se apenas a gráficos 3-D.
SecondCategoryAxis
Obtém o segundo eixo X do gráfico.
public Axis SecondCategoryAxis { get; }Valor da Propriedade
SecondValueAxis
Obtém o segundo eixo Y do gráfico.
public Axis SecondValueAxis { get; }Valor da Propriedade
SeriesAxis
Obtém o eixo de séries do gráfico.
public Axis SeriesAxis { get; }Valor da Propriedade
Shapes
Retorna todas as formas de desenho neste gráfico.
public ShapeCollection Shapes { get; }Valor da Propriedade
ShowDataTable
Obtém ou define um valor indicando se o gráfico exibe uma tabela de dados.
public bool ShowDataTable { get; set; }Valor da Propriedade
ShowLegend
Obtém ou define um valor indicando se a legenda do gráfico será exibida. O padrão é verdadeiro.
public bool ShowLegend { get; set; }Valor da Propriedade
SideWall
Retorna um objeto Aspose.Cells.Charts.Chart.Walls que representa a parede lateral de um gráfico 3-D.
public Walls SideWall { get; }Valor da Propriedade
SizeWithWindow
Verdadeiro se o Microsoft Excel redimensionar o gráfico para corresponder ao tamanho da janela da planilha do gráfico.
public bool SizeWithWindow { get; set; }Valor da Propriedade
Style
Obtém e define o estilo embutido.
public int Style { get; set; }Valor da Propriedade
Observações
Deve estar entre 1 e 48. Retorna -1 se não for definido.
SubTitle
Obtém o subtítulo do gráfico. Apenas para arquivo no formato ODS.
public Title SubTitle { get; }Valor da Propriedade
Title
Obtém o título do gráfico.
public Title Title { get; }Valor da Propriedade
Type
Obtém ou define o tipo de um gráfico.
public ChartType Type { get; set; }Valor da Propriedade
ValueAxis
Obtém o eixo Y do gráfico.
public Axis ValueAxis { get; }Valor da Propriedade
Walls
Retorna um objeto Aspose.Cells.Charts.Chart.Walls que representa as paredes de um gráfico 3-D.
public Walls Walls { get; }Valor da Propriedade
Observações
Esta propriedade não se aplica a gráficos de pizza 3-D.
WallsAndGridlines2D
Verdadeiro se as linhas de grade forem desenhadas bidimensionalmente em um gráfico 3-D.
public bool WallsAndGridlines2D { get; set; }Valor da Propriedade
Worksheet
Obtém a planilha que contém este gráfico.
public Worksheet Worksheet { get; }Valor da Propriedade
Métodos
Calculate()
Calcula a posição personalizada da área de plotagem, eixos se a posição deles for atribuída automaticamente.
public void Calculate()Calculate(ChartCalculateOptions)
Calcula a posição personalizada da área de plotagem, eixos se a posição deles for atribuída automaticamente, com opções de cálculo de gráfico.
public void Calculate(ChartCalculateOptions calculateOptions)Parâmetros
calculateOptions ChartCalculateOptions
ChangeTemplate(byte[])
Altera o tipo do gráfico com um modelo pré-definido.
public void ChangeTemplate(byte[] data)Parâmetros
data byte[]
Os dados do arquivo de modelo do gráfico (.crtx).
GetActualSize()
Obtém o tamanho real do gráfico em unidades de pixels.
public int[] GetActualSize()Retorna
int[]
Tamanho real em um array (largura e altura). [0] é largura; [1] é altura.
GetChartDataRange()
Obtém o intervalo da fonte de dados do gráfico.
public string GetChartDataRange()Retorna
A fonte de dados.
Observações
Apenas suporta intervalo.
HasAxis(AxisType, bool)
Retorna quais eixos existem no gráfico.
public bool HasAxis(AxisType aixsType, bool isPrimary)Parâmetros
aixsType AxisType
isPrimary bool
Retorna
Observações
Normalmente, Pizza, PizzaExplodida, PizzaPizza, PizzaBar, Pizza3D, Pizza3DExplodida, Rosquinha, RosquinhaExplodida não possuem eixo.
IsCellReferedByChart(int, int, int)
Retorna se a célula referida está no gráfico.
public bool IsCellReferedByChart(int sheetIndex, int rowIndex, int columnIndex)Parâmetros
sheetIndex int
O índice da planilha. -1 significa a planilha que contém o gráfico atual.
rowIndex int
O índice da linha
columnIndex int
O índice da coluna
Retorna
IsChartDataChanged()
Detecta se a fonte de dados de um gráfico foi alterada.
public bool IsChartDataChanged()Retorna
Retorna verdadeiro se o gráfico tiver mudado, caso contrário, retorna falso.
Observações
O método detecta as mudanças na fonte de dados do gráfico antes de renderizar o gráfico em formato de imagem. Na primeira chamada de Chart.toImage, os dados da fonte do gráfico (por exemplo, XValuesParseData, ValuesParseData) serão registrados. Antes de chamar o método Chart.toImage novamente, chame o método IsChartDataChanged para verificar se o gráfico precisa ser re-renderizado.
Move(int, int, int, int)
Move o gráfico para um local especificado.
public void Move(int upperLeftRow, int upperLeftColumn, int lowerRightRow, int lowerRightColumn)Parâmetros
upperLeftRow int
Índice da linha superior esquerda.
upperLeftColumn int
Índice da coluna superior esquerda.
lowerRightRow int
Índice da linha inferior direita.
lowerRightColumn int
Índice da coluna inferior direita.
RefreshPivotData()
Atualiza os dados do gráfico a partir da tabela dinâmica.
public void RefreshPivotData()Observações
Coletaremos dados da fonte de dados da tabela dinâmica para o relatório da tabela dinâmica. Este método é usado apenas para coletar todos os dados em um gráfico dinâmico.
SetChartDataRange(string, bool)
Especifica o intervalo de dados para um gráfico.
public void SetChartDataRange(string area, bool isVertical)Parâmetros
area string
Especifica os valores a partir dos quais plotar as séries de dados.
isVertical bool
Especifica se as séries devem ser plotadas a partir de um intervalo de valores de células por linha ou por coluna.
SwitchRowColumn()
Alterna linha/coluna.
public bool SwitchRowColumn()Retorna
Falso significa que a troca de linha/coluna falhou.
ToImage(string)
Cria a imagem do gráfico e a salva em um arquivo. A extensão do nome do arquivo determina o formato da imagem.
public void ToImage(string imageFile)Parâmetros
imageFile string
O nome do arquivo de imagem com o caminho completo.
Observações
O formato da imagem é especificado usando a extensão do nome do arquivo. Por exemplo, se você especificar "myfile.png", a imagem será salva no formato PNG. As seguintes extensões de arquivo são reconhecidas: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
Se a largura ou a altura for zero ou o gráfico não for suportado de acordo com a Lista de Gráficos Suportados, este método não fará nada.ToImage(string, ImageType)
Cria a imagem do gráfico e a salva em um arquivo no tipo de imagem especificado.
public void ToImage(string imageFile, ImageType imageType)Parâmetros
imageFile string
O nome do arquivo de imagem com o caminho completo.
imageType ImageType
O tipo de imagem no qual salvar a imagem.
Observações
O tipo da imagem é especificado usando `imageType`. Os seguintes tipos são suportados: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Se a largura ou a altura for zero ou o gráfico não for suportado de acordo com a Lista de Gráficos Suportados, este método não fará nada.ToImage(string, long)
Cria a imagem do gráfico e a salva em um arquivo no formato Jpeg.
public void ToImage(string imageFile, long jpegQuality)Parâmetros
imageFile string
O nome do arquivo de imagem com o caminho completo.
jpegQuality long
Qualidade Jpeg.
Observações
Se a largura ou a altura for zero ou o gráfico não for suportado de acordo com a Lista de Gráficos Suportados, este método não fará nada.
ToImage(Stream, long)
Cria a imagem do gráfico e a salva em um stream no formato Jpeg.
public void ToImage(Stream stream, long jpegQuality)Parâmetros
stream Stream
O stream de saída.
jpegQuality long
Qualidade Jpeg.
Observações
Se a largura ou a altura for zero ou o gráfico não for suportado de acordo com a Lista de Gráficos Suportados, este método não fará nada.
ToImage(Stream, ImageType)
Cria a imagem do gráfico e a salva em um stream no formato especificado.
public void ToImage(Stream stream, ImageType imageType)Parâmetros
stream Stream
O stream de saída.
imageType ImageType
O tipo de imagem no qual salvar a imagem.
Observações
O tipo da imagem é especificado usando `imageType`. Os seguintes formatos são suportados: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Se a largura ou a altura for zero ou o gráfico não for suportado de acordo com a Lista de Gráficos Suportados, este método não fará nada.ToImage(string, ImageOrPrintOptions)
Cria a imagem do gráfico e a salva em um arquivo. A extensão do nome do arquivo determina o formato da imagem.
public void ToImage(string imageFile, ImageOrPrintOptions options)Parâmetros
imageFile string
O nome do arquivo de imagem com o caminho completo.
options ImageOrPrintOptions
Opções adicionais de criação de imagem
Exemplos
Salva como Tiff com 300 dpi e compressão CCITT4.
ImageOrPrintOptions options = new ImageOrPrintOptions();
options.HorizontalResolution = 300;
options.VerticalResolution = 300;
options.TiffCompression = TiffCompression.CompressionCCITT4;
Workbook book = new Workbook(@"test.xls");
book.Worksheets[0].Charts[0].ToImage(@"chart.Tiff", options);
[VB]
Dim options As ImageOrPrintOptions = New ImageOrPrintOptions()
options.HorizontalResolution = 300
options.VerticalResolution = 300
options.TiffCompression = TiffCompression.CompressionCCITT4
Dim book As Workbook = New Workbook("test.xls")
book.Worksheets(0).Charts(0).ToImage("chart.Tiff", options)Salva como Jpeg com 300 dpi e qualidade de imagem 80.
ImageOrPrintOptions options = new ImageOrPrintOptions();
options.HorizontalResolution = 300;
options.VerticalResolution = 300;
options.Quality = 80;
Workbook book = new Workbook(@"test.xls");
book.Worksheets[0].Charts[0].ToImage(@"chart.Jpeg", options);
[VB]
Dim options As ImageOrPrintOptions = New ImageOrPrintOptions()
options.HorizontalResolution = 300
options.VerticalResolution = 300
options.Quality = 80
Dim book As Workbook = New Workbook("test.xls")
book.Worksheets(0).Charts(0).ToImage("chart.Jpeg", options)Observações
O formato da imagem é especificado usando a extensão do nome do arquivo. Por exemplo, se você especificar "myfile.png", a imagem será salva no formato PNG. As seguintes extensões de arquivo são reconhecidas: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
Se a largura ou a altura for zero ou o gráfico não for suportado de acordo com a Lista de Gráficos Suportados, este método não fará nada. Consulte Lista de Gráficos Suportados para mais detalhes.ToImage(Stream, ImageOrPrintOptions)
Cria a imagem do gráfico e a salva em um stream no formato especificado.
public void ToImage(Stream stream, ImageOrPrintOptions options)Parâmetros
stream Stream
O stream de saída.
options ImageOrPrintOptions
Opções adicionais de criação de imagem
Observações
O tipo da imagem é especificado usando `options.ImageType`. Os seguintes formatos são suportados: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Se a largura ou a altura for zero ou o gráfico não for suportado de acordo com a Lista de Gráficos Suportados, este método não fará nada. Consulte Lista de Gráficos Suportados para mais detalhes.ToPdf(string)
Salva o gráfico em um arquivo pdf.
public void ToPdf(string fileName)Parâmetros
fileName string
o nome do arquivo pdf com o caminho completo
ToPdf(string, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)
Salva o gráfico em um arquivo pdf.
public void ToPdf(string fileName, float desiredPageWidth, float desiredPageHeight, PageLayoutAlignmentType hAlignmentType, PageLayoutAlignmentType vAlignmentType)Parâmetros
fileName string
o nome do arquivo pdf com o caminho completo
desiredPageWidth float
A largura da página desejada em polegadas.
desiredPageHeight float
A altura da página desejada em polegadas.
hAlignmentType PageLayoutAlignmentType
O tipo de alinhamento horizontal do gráfico na página de saída.
vAlignmentType PageLayoutAlignmentType
O tipo de alinhamento vertical do gráfico na página de saída.
ToPdf(Stream)
Cria o pdf do gráfico e o salva em um stream.
public void ToPdf(Stream stream)Parâmetros
stream Stream
O stream de saída.
ToPdf(Stream, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)
Cria o pdf do gráfico e o salva em um stream.
public void ToPdf(Stream stream, float desiredPageWidth, float desiredPageHeight, PageLayoutAlignmentType hAlignmentType, PageLayoutAlignmentType vAlignmentType)Parâmetros
stream Stream
O stream de saída.
desiredPageWidth float
A largura da página desejada em polegadas.
desiredPageHeight float
A altura da página desejada em polegadas.
hAlignmentType PageLayoutAlignmentType
O tipo de alinhamento horizontal do gráfico na página de saída.
vAlignmentType PageLayoutAlignmentType
O tipo de alinhamento vertical do gráfico na página de saída.
