Compartilhar via


Método Chart.GetChartElement (Project)

Devolve informações sobre o elemento de gráfico em coordenadas X e Y especificadas. Este 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 é devolvido, ElementID contém o valor Office.XLChartItem do elemento de gráfico nas coordenadas especificadas. Para obter mais informações, veja Observações.
Arg1 Obrigatório Long Quando o método é devolvido, o Arg1 contém informações relacionadas com o elemento do gráfico. Para obter mais informações, veja Observações.
Arg2 Obrigatório Long Quando o método é devolvido, o Arg2 contém informações relacionadas com o elemento do gráfico. Para obter mais informações, veja Observações.

Valor de retorno

O método GetChartElement devolve Nada. Os valores devolvidos 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 Gráfico no Project não implementa eventos; Portanto, um gráfico no Project não pode ser animado com o método GetChartElement ao interagir com eventos do rato.

O método GetChartElement é invulgar porque especifica valores apenas para os dois primeiros argumentos. O Project devolve dados nos outros argumentos e o código deve examinar esses valores quando o método é devolvido.

O valor de ElementID após a devolução do método determina se Arg1 e Arg2 contêm alguma informação (consulte Tabela 1).

Tabela 1. Informações em Arg1 e Arg2, com base no ID do elemento

Constante da ID do elemento Valor da 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 2 descreve o significado de Arg1 e Arg2 após a devolução 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
EixoIndex 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 desvio na coleção Office.IMsoChart.ChartGroups para um grupo de gráficos específico.
PivotFieldIndex Especifica o desvio na coleção Excel.PivotFields para uma coluna (série) específica, dados, página ou campo de linha (categoria). O valor é -1 se o tipo de zona de colocação for xlDataField.
PointIndex Especifica o desvio na coleção Office.IMsoSeries.Points para um ponto específico numa série. Um valor de 1 indica que todos os pontos de dados estão selecionados.
SeriesIndex Especifica o desvio no 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 desvio na coleção Office.IMsoSeries.Trendlines para uma linha de tendência específica numa série.

Exemplo

O exemplo seguinte obtém as informações do elemento de gráfico para o ponto (100, 100) no gráfico. Por exemplo, se o ponto estiver dentro da área de desenho, a saída no painel Imediato é idNum: 19, a: 0, b: 0. A partir 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

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.