Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
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.