Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Devolve informações sobre o elemento de 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 o código deve examinar esses valores quando o método for devolvido.
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 do gráfico. |
| y | Obrigatório | Long | A coordenada y do elemento do gráfico. |
| ElementID | Obrigatório | Long | Quando o método é devolvido, este argumento contém o valor XLChartItem do elemento do 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 | EixoIndex | AxisType |
| xlAxisTitle | 17 | EixoIndex | AxisType |
| xlDisplayUnitLabel | 30 | EixoIndex | AxisType |
| xlMajorGridlines | 15 | EixoIndex | AxisType |
| xlMinorGridlines | 16 | EixoIndex | 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 |
|---|---|
| EixoIndex | 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 desvio na coleção Campos Dinâmicos para um campo específico de coluna (série), dados, página ou linha (categoria). -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.