Classe Chart - gráfico (Excel VBA)

A classe Chart representa um gráfico em uma pasta de trabalho.

As classes Application, ChartObject, Shape, Window e Workbook. dão acesso à classe Chart


Dim chr as Chart
Set chr = ActiveChart

For Each

Aqui está um exemplo de processamento dos itens Chart em uma coleção. 


Dim chr As Chart
For Each chr In Charts
	
Next chr

Métodos

ApplyDataLabels - Aplica rótulos de dados a todas as séries em um gráfico. 


Charts("Chart1").SeriesCollection(1). _ 
 ApplyDataLabels Type:=xlDataLabelsShowLabel

ChartWizard - Modifica as propriedades do gráfico especificado. Você pode usar esse método para formatar rapidamente um gráfico sem definir todas as propriedades individuais. Este método não é interativo e só altera as propriedades especificadas. 


Charts("Chart1").ChartWizard _ 
 Gallery:=xlLine, _ 
 HasLegend:=True, CategoryTitle:="Year", ValueTitle:="Sales"

Refresh - Faz com que o gráfico especificado seja redesenhado imediatamente. 


ActiveChart.Refresh

SetSourceData - Define o intervalo de dados de origem para o gráfico. 


Charts(1).SetSourceData Source:=Sheets(1).Range("a1:a10"), _ 
 PlotBy:=xlColumns

Activate -

ApplyChartTemplate - Aplica um tipo de gráfico personalizado ou padrão a um gráfico.

ApplyLayout - Aplica os layouts mostrados na faixa de opções.

Axes - Retorna um objeto que representa um único eixo ou uma coleção de eixos em um gráfico.

ChartGroups - Retorna um objeto que representa um único grupo de gráficos um objeto ChartGroup ou uma coleção de todos os grupos de gráficos no gráfico (um objeto ChartGroups ). A coleção retornada inclui todos os tipos de grupo.

ChartObjects - Retorna um objeto que representa um único gráfico incorporado um objeto ChartObject ou uma coleção de todos os gráficos incorporados (um objeto ChartObjects ) na planilha.

CheckSpelling - Verifica a ortografia de um objeto.

ClearToMatchColorStyle - Limpa todas as cores no gráfico especificado que não seguem o estilo de cor aplicado ao gráfico.

ClearToMatchStyle - Limpa a formatação dos elementos gráficos para automático.

Copy - Copia a planilha para outro local na pasta de trabalho.

CopyPicture - Copia o objeto selecionado para a Área de Transferência como uma imagem.

Delete - Exclui o objeto.

Evaluate - Converte um nome do Microsoft Excel em um objeto ou em um valor.

Export - Exporta o gráfico em um formato gráfico.

ExportAsFixedFormat - Exporta para um arquivo do formato especificado.

FullSeriesCollection - Permite recuperar a série de saída filtrada especificada pelo argumento index .

GetChartElement - Retorna informações sobre o elemento de gráfico nas coordenadas x e y especificadas. Esse método é incomum porque você especifica valores apenas para os dois primeiros argumentos. O Microsoft Excel preenche os outros argumentos e o código deve examinar esses valores quando o método retornar.

GetProperty -

Location - Move o gráfico para uma nova posição.

Move - Move o gráfico para outro lugar na pasta de trabalho.

OLEObjects - Retorna um objeto que representa um único objeto OLE um OLEObject ou uma coleção de todos os objetos OLE (uma coleção OLEObjects) no gráfico ou planilha. Somente leitura.

Paste - Cola dados de gráfico da Área de Transferência para o gráfico especificado.

PrintOut - Imprime o objeto.

PrintPreview - Mostra uma visualização de como o objeto aparecerá quando for impresso.

Protect - Protege um gráfico contra modificação.

SaveAs - Salva alterações feitas no gráfico ou na planilha em um arquivo diferente.

SaveChartTemplate - Salva um modelo de gráfico personalizado na lista de modelos de gráficos disponíveis.

Select -

SeriesCollection - Retorna um objeto que representa uma única série um objeto Series ou uma coleção de todas as séries (uma coleção SeriesCollection ) no gráfico ou grupo de gráficos.

SetBackgroundPicture - Define um gráfico de plano de fundo para um gráfico.

SetDefaultChart - Especifica o nome do modelo de gráfico que o Microsoft Excel usa ao criar novos gráficos.

SetElement - Conjuntos de elementos em um gráfico do gráfico. Leitura/gravação MsoChartElementType.

SetProperty -

Unprotect - Remove a proteção de uma planilha ou de uma pasta de trabalho. Esse método não terá efeito caso a planilha ou a pasta de trabalho não esteja protegida.

Propriedades

AutoScaling True se o Microsoft Excel dimensiona um gráfico 3D para que fique mais perto do tamanho do gráfico 2D equivalente. A propriedade RightAngleAxes deve ser verdadeiras. Boolean de leitura/gravação.

BackWall Retorna um objeto Walls que permite que o usuário formate individualmente a parede traseira de um gráfico 3D. Somente leitura.

BarShape Retorna ou define a forma usada com o gráfico de colunas ou barra 3D. XlBarShape de leitura/gravação.

CategoryLabelLevel Retorna uma constante XlCategoryLabelLevel que se refere ao nível de onde os rótulos de categoria estão sendo originados. número inteiro de leitura/gravação.

ChartArea Retorna um objeto ChartArea que representa a área completa do gráfico para o gráfico. Somente leitura.

ChartColor Retorna ou define um inteiro que representa o esquema de cores do gráfico. Leitura/gravação.

ChartStyle Retorna ou define o estilo de gráfico do gráfico. de leitura/gravação.

ChartTitle Retorna um objeto ChartTitle que representa o título do gráfico especificado. Somente leitura.

ChartType Retorna ou define o tipo de gráfico. XlChartType de leitura/gravação.

CodeName Retorna o nome de código do objeto. String somente leitura.

DataTable Retorna um objeto DataTable que representa a tabela de dados do gráfico. Somente leitura.

DepthPercent Retorna ou define a profundidade de um gráfico 3D como um percentual da largura do gráfico entre 20 e 2000 por cento. Long de leitura/gravação.

DisplayBlanksAs Retorna ou define a forma com que as células vazias são plotadas em um gráfico. Pode ser uma das seguintes constantes XlDisplayBlanksAs. Long de leitura/gravação.

DisplayValueNotAvailableAsBlank

Elevation Retorna ou define a elevação do modo de exibição do gráfico 3D, em graus. Long de leitura/gravação.

Floor Retorna um objeto Floor que representa a base do gráfico 3D. Somente leitura.

GapDepth Retorna ou define a distância entre a série de dados em um gráfico 3D como um percentual da largura do marcador. O valor dessa propriedade precisa estar entre 0 e 500. Long de leitura/gravação.

HasAxis Retorna ou define quais eixos existem no gráfico. de leitura/gravação.

HasDataTable True se o gráfico possui uma tabela de dados. Boolean de leitura/gravação.

HasLegend True se o gráfico tem uma legenda. Boolean de leitura/gravação.

HasTitle True se o eixo ou o gráfico tem um título visível. Boolean de leitura/gravação.

HeightPercent Retorna ou define a altura de um gráfico 3D como um percentual da largura do gráfico entre 5 e 500 por cento. Long de leitura/gravação.

Hyperlinks Retorna uma coleção hyperlinks que representa os hiperlinks do gráfico.

Index Retorna um valor Long que representa o número de índice do objeto dentro da coleção de objetos semelhantes.

Legend Retorna um objeto Legend que representa a legenda do gráfico. Somente leitura.

MailEnvelope Representa um cabeçalho de email para um documento.

Name Retorna ou define um valor String que representa o nome do objeto.

Next Retorna um objeto Worksheet que representa a próxima planilha.

PageSetup Retorna um objeto PageSetup que contém todas as definições de configuração de página para o objeto especificado. Somente leitura.

Perspective Retorna ou define um valor Long que representa a perspectiva para o modo de exibição de gráfico 3D.

PivotLayout Retorna um objeto PivotLayout que representa o posicionamento de campos em um relatório de tabela dinâmica e o posicionamento de eixos em um relatório de gráfico dinâmico. Somente leitura.

PlotArea Retorna um objeto PlotArea que representa a área de plotagem de um gráfico. Somente leitura.

PlotBy Retorna ou define como as colunas ou linhas são usadas como séries de dados no gráfico. Pode ser uma das seguintes constantes XlRowCol : xlColumns ou xlRows. Long de leitura/gravação.

PlotVisibleOnly True se somente as células visíveis são plotadas. False se as células visíveis quanto ocultas são plotadas. Boolean de leitura/gravação.

Previous Retorna um objeto Worksheet que representa a planilha anterior.

PrintedCommentPages Retorna o número de páginas de comentários que serão impressas para o gráfico atual. Somente leitura.

ProtectContents True se o conteúdo da planilha estiver protegido. Para um gráfico, isso protege o gráfico inteiro. Para ativar a proteção de conteúdo, use o método Protect com o argumento Content definido como true. Boolean somente leitura.

ProtectData True se o usuário não puder modificar as fórmulas de série. Boolean de leitura/gravação.

ProtectDrawingObjects True se as formas estiverem protegidas. Para ativar a proteção de forma, use o método Protect com o argumento DrawingObjects definido como true. Boolean somente leitura.

ProtectFormatting True se o usuário não puder modificar a formatação do gráfico. Boolean de leitura/gravação.

ProtectionMode True se a proteção somente da interface do usuário estiver ativada. Para ativar a proteção da interface do usuário, use o método Protect com o argumento UserInterfaceOnly definido como true. Boolean somente leitura.

ProtectSelection True se não for possível selecionar elementos de gráfico. Boolean de leitura/gravação.

RightAngleAxes True se os eixos do gráfico estiverem em reto, independentemente de rotação de gráfico ou a elevação. Só se aplica a gráficos de linhas, colunas e barras 3D. Boolean de leitura/gravação.

Rotation Retorna ou define a rotação do modo de exibição de gráfico 3D a rotação da área de plotagem em torno do eixo z, em graus. O valor dessa propriedade deve ser de 0 a 360, exceto para gráficos de barras 3D, onde o valor deve ser de 0 a 44. O valor padrão é 20. Aplica-se apenas a gráficos 3D. de leitura/gravação.

SeriesNameLevel Retorna uma constante XlSeriesNameLevel que se refere ao nível de onde os nomes das séries estão sendo originados. número inteiro de leitura/gravação.

Shapes Retorna uma coleção Shapes que representa todas as formas na planilha de gráfico. Somente leitura.

ShowAllFieldButtons Retorna ou define se todos os botões de campo devem ser exibidos em um gráfico dinâmico. Leitura/gravação.

ShowAxisFieldButtons Retorna ou define se os botões de campo do eixo devem ser exibidos em um gráfico dinâmico. Leitura/gravação.

ShowDataLabelsOverMaximum Retorna ou define se os rótulos de dados devem ser mostrados quando o valor for maior do que o valor máximo no eixo dos valores. Boolean de leitura/gravação.

ShowExpandCollapseEntireFieldButtons True para exibir os botões Expandir Todo o Campo e Recolher Todo o Campo no gráfico dinâmico especificado. Boolean de leitura/gravação.

ShowLegendFieldButtons Retorna ou define se os botões de campo de legenda devem ser exibidos em um gráfico dinâmico. Leitura/gravação.

ShowReportFilterFieldButtons Retorna ou define se os botões de campo de filtro de relatório devem ser exibidos em um gráfico dinâmico. Leitura/gravação.

ShowValueFieldButtons Retorna ou define se os botões de campo de valor devem ser exibidos em um gráfico dinâmico. Leitura/gravação.

SideWall Retorna um objeto Walls que permite que o usuário formate individualmente a parede lateral de um gráfico 3D. Somente leitura.

Tab Retorna um objeto Tab para um gráfico.

Visible Retorna ou define um valor XlSheetVisibility que determina se o objeto está visível.

Walls Retorna um objeto Walls que representa as paredes do gráfico 3D. Somente leitura.

Axes - Uma coleção de todos os objetos Axis no gráfico especificado.

ChartArea - Representa a área de gráfico de um gráfico.

ChartGroups - Representa uma ou mais sequências plotadas em um gráfico com o mesmo formato.

ChartObjects - Uma coleção de todos os objetos ChartObject na planilha de gráfico, na planilha de diálogo ou na planilha especificada.

ChartTitle - Representa o título do gráfico.

DataTable - Representa uma tabela de dados de gráfico.

Floor - Representa a base de um gráfico 3D.

FullSeriesCollection - Representa o conjunto completo de objetos Series em um gráfico.

Hyperlinks - Representa a coleção de hiperlinks para uma planilha ou um intervalo.

Legend - Representa a legenda em um gráfico. Cada gráfico pode ter apenas uma legenda.

OLEObjects - Uma coleção de todos os objetos OLEObject na planilha especificada.

PageSetup - Representa a descrição das configurações de página.

PivotLayout - Representa a posição dos campos em um relatório de gráfico dinâmico.

PlotArea - Representa a área de plotagem de um gráfico.

SeriesCollection - Uma coleção de todos os objetos Series no gráfico ou no grupo de gráficos especificado.

Shapes - Uma coleção de todos os objetos Shape na planilha especificada.

Tab - Representa a guia de um gráfico ou de uma planilha.

Walls - Representa as paredes de um gráfico 3D. Esse objeto não é uma coleção. Não há nenhum objeto que representa uma parede única; você deve retornar todas as paredes como uma unidade.

Worksheet - Representa uma planilha.