Método Chart.GetChartElement (Excel)

Retorna informações sobre o elemento gráfico em 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 seu código deve examinar esses valores quando o método retornar.

Sintaxe

expressão. GetChartElement (x, y, ElementID, Arg1, Arg2)

expressão Uma variável que representa um objeto Chart.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
x	Obrigatório	Long	A coordenada x do elemento gráfico.
y	Obrigatório	Long	A coordenada y do elemento gráfico.
Elementid	Obrigatório	Long	Quando o método retorna, esse argumento contém o valor XLChartItem do elemento gráfico nas coordenadas especificadas. Para mais informações, consulte a seção Comentários.
Arg1	Obrigatório	Long	Quando o método retorna, esse argumento contém informações relacionadas ao elemento de gráfico. Para obter mais informações, consulte a seção Comentários.
Arg2	Obrigatório	Long	Quando o método retorna, esse argumento contém informações relacionadas ao elemento de gráfico. Para obter mais informações, consulte a seção Comentários.

Comentários

O valor de ElementID após o método retornar determina se Arg1 e Arg2 contêm alguma informação, como mostrado na tabela seguinte.

Constante ElementID	Valor constante	Arg1	Arg2
xlAxis	21	AxisIndex	Axistype
xlAxisTitle	17	AxisIndex	Axistype
xlDisplayUnitLabel	30	AxisIndex	Axistype
xlMajorGridlines	15	AxisIndex	Axistype
xlMinorGridlines	16	AxisIndex	Axistype
xlPivotChartDropZone	32	DropZoneType	Nenhum
xlPivotChartFieldButton	31	DropZoneType	PivotFieldIndex
xlDownBars	20	GroupIndex	Nenhum
xlDropLines	26	GroupIndex	Nenhuma
xlHiLoLines	25	GroupIndex	Nenhum
xlRadarAxisLabels	27	GroupIndex	Nenhuma
xlSeriesLines	22	GroupIndex	Nenhum
xlUpBars	18	GroupIndex	Nenhum
xlChartArea	2	Nenhum	Nenhum
xlChartTitle	4	Nenhum	Nenhum
xlCorners	6	Nenhum	Nenhum
xlDataTable	7	Nenhum	Nenhum
xlFloor	23	Nenhum	Nenhum
xlLeaderLines	29	Nenhum	Nenhum
xlLegend	24	Nenhum	Nenhum
xlNothing	28	Nenhum	Nenhum
xlPlotArea	19	Nenhum	Nenhum
xlWalls	5	Nenhum	Nenhum
xlDataLabel	7	SeriesIndex	PointIndex
xlErrorBars	9	SeriesIndex	Nenhum
xlLegendEntry	12	SeriesIndex	Nenhum
xlLegendKey	13	SeriesIndex	Nenhum
xlSeries	3	SeriesIndex	PointIndex
xlShape	14	ShapeIndex	Nenhum
xlTrendline	8	SeriesIndex	TrendLineIndex
xlXErrorBars	10	SeriesIndex	Nenhuma
xlYErrorBars	11	SeriesIndex	Nenhum

A tabela seguinte descreve o significado de Arg1 e Arg2 após o método retornar.

Argumento	Descrição
AxisIndex	Especifica se o eixo é primário ou secundário. Pode ser uma das seguintes constantes XlAxisGroup: xlPrimary ou xlSecondary.
Axistype	Especifica o tipo de eixo. Pode ser uma das seguintes constantes XlAxisType: xlCategory, xlSeriesAxis ou xlValue.
DropZoneType	Especifica o tipo de zona soltar: campo de linha, dados, página ou coluna. Pode ser uma das seguintes constantes XlPivotFieldOrientation: xlColumnField, xlDataField, xlPageField ou xlRowField. As constantes de campo de coluna e linha especificam os campos de série e categoria, respectivamente.
GroupIndex	Especifica o deslocamento dentro da coleção ChartGroups para um grupo gráfico específico.
PivotFieldIndex	Especifica o deslocamento dentro da coleção PivotFields para um campo de coluna (série), dados, página ou linha (categoria) específico. -1 se o tipo da zona de posicionamento for xlDataField.
PointIndex	Especifica o deslocamento dentro da coleção de pontos para um ponto específico dentro de uma série. Um valor de 1 indica que todos os pontos de dados estão selecionados.
SeriesIndex	Especifica o deslocamento dentro da coleção Series para uma série específica.
ShapeIndex	Especifica o deslocamento dentro da coleção Shapes para uma forma específica.
TrendlineIndex	Especifica o deslocamento dentro da coleção Trendlines para uma linha de tendência específica dentro de uma série.

Exemplo

Este exemplo avisa o usuário quando o mouse é posicionado sobre a legenda do gráfico.

Private Sub Chart_MouseMove(ByVal Button As Long, _ 
 ByVal Shift As Long, ByVal X As Long, ByVal Y As Long) 
 Dim IDNum As Long 
 Dim a As Long 
 Dim b As Long 
 
 ActiveChart.GetChartElement X, Y, IDNum, a, b 
 If IDNum = xlLegendEntry Then _ 
 MsgBox "WARNING: Move away from the legend" 
End Sub

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.