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

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.