Ler em inglês

Compartilhar via


Método item (Excel Graph)

O método Item como ele se aplica às coleções Axes, ChartGroups, DataLabels, LegendEntries, Points, SeriesCollection e Trendlines .

Coleção Axes

Retorna um único objeto Axis de uma coleção Axes.

Sintaxe

expressão. Item (Tipo, AxisGroup)

expressão Obrigatório. Uma expressão que retorna uma coleção axes .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Type Obrigatório XlAxisType O tipo de eixo. Pode ser uma dessas constantes XlAxisType : xlCategory, xlSeriesAxis (válida apenas para gráficos 3D) ou xlValue.
AxisGroup Opcional XlAxisGroup O grupo do eixo. Pode ser uma dessas constantes xlAxisGroup : xlSecondary ou xlPrimary (padrão).

Exemplo

Este exemplo define o texto do título como o eixo de categoria em Chart1.

With Charts("chart1").Axes.Item(xlCategory) 
 .HasTitle = True 
 .AxisTitle.Caption = "1994" 
End With

Coleção ChartGroups

Retorna um único objeto ChartGroup de uma coleção ChartGroups .

Sintaxe

expressão. Item (Índice)

expressão Obrigatório. Uma expressão que retorna uma coleção ChartGroups .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Índice Obrigatório Variantes O número de índice do grupo de gráficos.

Exemplo

Este exemplo adiciona linhas de projeção ao grupo de gráficos um na planilha de gráfico um.

Charts(1).ChartGroups.Item(1).HasDropLines = True

Coleção DataLabels

Retorna um único objeto DataLabel de uma coleção DataLabels .

Sintaxe

expressão. Item (Índice)

expressão Obrigatório. Uma expressão que retorna uma coleção DataLabels .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Índice Obrigatório Variantes O nome ou o número de índice do rótulo de dados.

Exemplo

Este exemplo define o formato do número para o quinto rótulo de dados na série um do gráfico incorporado um da planilha um.

Worksheets(1).ChartObjects(1).Chart _ 
 .SeriesCollection(1).DataLabels.Item(5).NumberFormat = "0.000"

Coleção LegendEntries

Retorna um único objeto LegendEntry de uma coleção LegendEntries .

Sintaxe

expressão. Item (Índice)

expressão Obrigatório. Uma expressão que retorna uma coleção LegendEntries .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Índice Obrigatório Variantes O número de índice da entrada da legenda.

Exemplo

Este exemplo altera a fonte para o texto da entrada de legenda na parte superior da legenda (que geralmente é a legenda da série um) no gráfico incorporado um de Sheet1.

Worksheets("sheet1").ChartObjects(1).Chart _ 
 .Legend.LegendEntries.Item(1).Font.Italic = True

Coleção Points

Retorna um único objeto Point de uma coleção Points .

Sintaxe

expressão. Item (Índice)

expressão Obrigatório. Uma expressão que retorna uma coleção Points .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Índice Obrigatório Long O número de índice do ponto.

Exemplo

Este exemplo define o estilo do marcador para o terceiro ponto da série um do gráfico incorporado um na planilha um. A série especificada deve ser uma linha 2D, dispersão ou série de radar.

Worksheets(1).ChartObjects(1).Chart. _ 
 SeriesCollection(1).Points.Item(3).MarkerStyle = xlDiamond

Coleção SeriesCollection

Retorna um único objeto Series de uma coleção SeriesCollection .

Sintaxe

expressão. Item (Índice)

expressão Obrigatório. Uma expressão que retorna uma coleção SeriesCollection .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Índice Obrigatório Variantes O nome ou o número de índice da série.

Exemplo

Este exemplo fornece duas linhas de código equivalentes.

myChart.SeriesCollection.Item(1) 
myChart.SeriesCollection(1)

Coleção Trendlines

Retorna um único objeto Trendline de uma coleção Trendlines .

Sintaxe

expressão. Item (Índice)

expressão Obrigatório. Uma expressão que retorna uma coleção Trendlines .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Índice Opcional Variantes O nome ou o número de índice da linha de tendência.

Exemplo

Este exemplo define o número de unidades pelas quais a linha de tendência de Chart1 se estende para frente e para trás. O exemplo deve ser executado em um gráfico de colunas 2D que contém uma única série com uma linha de tendência.

With Charts("Chart1").SeriesCollection(1).Trendlines.Item(1) 
 .Forward = 5 
 .Backward = .5 
End With

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.