Método Chart.GetChartElement (Projeto)

Retorna informações sobre o elemento do gráfico nas coordenadas X e Y especificadas. Este método será removido na versão de lançamento do Project 2013.

Sintaxe

mais simples. 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, ElementID contém o valor Office.XLChartItem do elemento do gráfico nas coordenadas especificadas. Para obter mais informações, consulte Comentários.
Arg1 Obrigatório Long Quando o método retorna, Arg1 contém informações relacionadas ao elemento chart. Para obter mais informações, consulte Comentários.
Arg2 Obrigatório Long Quando o método retorna, Arg2 contém informações relacionadas ao elemento chart. 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 de lançamento 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 de ElementID após o retorno do método determina se Arg1 e Arg2 contêm alguma informação (consulte a Tabela 1).

Tabela 1. Informações em Arg1 e 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
xlNada 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 dos dados em Arg1 e Arg2

Argumento Descrição
AxisIndex Especifica se o eixo é primário ou secundário. Pode ser uma das seguintes constantes Office.XlAxisGroup : xlPrimary ou xlSecondary.
AxisType Especifica o tipo de eixo. Pode ser uma das seguintes constantes 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 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 específico de coluna (série), dados, página ou linha (categoria). O valor é -1 se o tipo de zona para soltar for xlDataField.
PointIndex Especifica o deslocamento dentro da coleção Office.IMsoSeries.Points 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 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 dentro de uma série.

Exemplo

O exemplo a seguir obtém as informações do elemento do 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. A partir das informações da 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

Objeto Chart

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.