Método Chart.GetChartElement (Project)
Retorna informações sobre o elemento gráfico nas coordenadas X e Y especificadas. Esse método será removido na versão lançada do Project 2013.
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 de gráfico. |
| y | Obrigatório | Long | A coordenada Y do elemento de gráfico. |
| Elementid | Obrigatório | Long | Quando o método GetChartElement retorna, ElementIDcontém o valor Office.XLChartItem do elemento gráfico nas coordenadas especificadas. Para obter mais informações, consulte Comentários. |
| Arg1 | Obrigatório | Long | Quando o método retorna, o Arg1 contém informações relacionadas ao elemento gráfico. Para obter mais informações, consulte Comentários. |
| Arg2 | Obrigatório | Long | Quando o método retorna, o Arg2 contém informações relacionadas ao elemento gráfico. Para obter mais informações, consulte Comentários. |
Valor de retorno
O método GetChartElement retorna Nothing. Os valores retornados estão nos parâmetros ElementID, Arg1 e Arg2 .
Comentários
Observação
O método GetChartElement será removido na versão lançada do Project 2013. O objeto Chart no Project não implementa eventos; portanto, um gráfico no Project não pode ser animado com o método GetChartElement interagindo com eventos do mouse.
O método GetChartElement é incomum porque você especifica valores apenas para os dois primeiros argumentos. O Project retorna dados nos outros argumentos e seu código deve examinar esses valores quando o método retornar.
O valor do ElementID após o retorno do método determina se o Arg1 e o Arg2 contêm informações (consulte Tabela 1).
Tabela 1. Informações no Arg1 e no Arg2, com base na ID do elemento
| Constante da ID do elemento | Valor da 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 2 descreve o significado de Arg1 e Arg2 após o retorno do método. Os valores na coluna Argumento são da Tabela 1.
Tabela 2. Significado de dados no Arg1 e no Arg2
| Argumento | Descrição |
|---|---|
| AxisIndex | Especifica se o eixo é primário ou secundário. Pode ser uma das seguintes constantes do Office.XlAxisGroup : xlPrimary ou xlSecondary. |
| Axistype | Especifica o tipo de eixo. Pode ser uma das seguintes constantes do Office.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 do Office.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 Office.IMsoChart.ChartGroups para um grupo de gráficos específico. |
| PivotFieldIndex | Especifica o deslocamento dentro da coleção Excel.PivotFields para um campo de coluna (série), dados, página ou linha (categoria) específico. O valor será -1 se o tipo de zona suspensa for xlDataField. |
| PointIndex | Especifica o deslocamento dentro da coleção Office.IMsoSeries.Points para um ponto específico em uma série. Um valor de 1 indica que todos os pontos de dados estão selecionados. |
| SeriesIndex | Especifica o deslocamento dentro do Office.IMsoChart.SeriesCollection 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 Office.IMsoSeries.Trendlines para uma linha de tendência específica em uma série. |
Exemplo
O exemplo a seguir obtém as informações do elemento gráfico para o ponto (100, 100) no gráfico. Por exemplo, se o ponto estiver dentro da área de plotagem, a saída no painel Imediato será idNum: 19, a: 0, b: 0. Das informações na Tabela 1, xlPlotArea = 19.
Sub TestGetChartElements()
Dim chartShape As Shape
Dim reportName As String
Dim x As Long
Dim y As Long
Dim idNum As Long
Dim a As Long
Dim b As Long
reportName = "Simple scalar chart"
Set chartShape = ActiveProject.Reports(reportName).Shapes(1)
' Specify a point in the chart.
x = 100
y = 100
chartShape.Chart.GetChartElement x, y, idNum, a, b
Debug.Print "idNum: " & idNum & ", a: " & a & ", b: " & b
End Sub
Confira também
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.