Table of contents
TOC
Recolher sumário
Expandir sumário

Método Chart.GetChartElement (projeto)Chart.GetChartElement Method (Project)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

Retorna informações sobre o elemento de gráfico nas especificadas coordenadas X e Y. Esse método será removido na versão lançada do Project 2013.Returns information about the chart element at specified X and Y coordinates. This method will be removed in the released version of Project 2013.

SintaxeSyntax

expressão. GetChartElement(x,? y? ElementID? Arg1? Arg2)expression. GetChartElement(x,? y,? ElementID,? Arg1,? Arg2)

expressão Uma variável que representa um objeto Chart .expression A variable that represents a Chart object.

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData typeDescriçãoDescription
xxObrigatórioRequiredLongLongA coordenada X do elemento de gráfico.The X coordinate of the chart element.
yyObrigatórioRequiredLongLongA coordenada Y do elemento de gráfico.The Y coordinate of the chart element.
ElementIDElementIDObrigatórioRequiredLongLongQuando o método GetChartElement retorna, ElementID contém o valor de Office.XLChartItem do elemento de gráfico nas coordenadas especificadas. Para obter mais informações, consultecomentários.When the GetChartElement method returns, ElementID contains the Office.XLChartItem value of the chart element at the specified coordinates. For more information, seeRemarks.
Arg1Arg1ObrigatórioRequiredLongLongQuando o método retorna, Arg1 contém informações relacionadas ao elemento do gráfico. Para obter mais informações, consultecomentários.When the method returns, Arg1 contains information related to the chart element. For more information, seeRemarks.
Arg2Arg2ObrigatórioRequiredLongLongQuando o método retorna, Arg2 contém informações relacionadas ao elemento do gráfico. Para obter mais informações, consultecomentários.When the method returns, Arg2 contains information related to the chart element. For more information, seeRemarks.
xxObrigatórioRequiredINT32INT32
yyObrigatórioRequiredINT32INT32
ElementIDElementIDObrigatórioRequiredINT32INT32
Arg1Arg1ObrigatórioRequiredINT32INT32
Arg2Arg2ObrigatórioRequiredINT32INT32

Valor de retornoReturn value

O método GetChartElement retornará Nothing. Os valores retornados são nos parâmetros ElementID, Arg1_e _Arg2 .The GetChartElement method returns Nothing. Returned values are in the ElementID, Arg1, and Arg2 parameters.

ComentáriosRemarks

Observação O método GetChartElement será removido na versão lançada do Project 2013. O objeto de gráfico no projeto não implementa eventos; Portanto, um gráfico em um projeto não pode ser animado com o método GetChartElement por meio da interação com os eventos de mouse.Note The GetChartElement method will be removed in the released version of Project 2013. The Chart object in Project does not implement events; so, a chart in Project cannot be animated with the GetChartElement method by interacting with mouse events.

O método GetChartElement é incomum porque você especificar valores para apenas os dois primeiros argumentos. Project retorna dados nos outros argumentos e seu código deverá examinar esses valores quando o método retorna.The GetChartElement method is unusual because you specify values for only the first two arguments. Project returns data in the other arguments, and your code should examine those values when the method returns.

O valor de ElementID após o método retornar determina se Arg1 e Arg2 contêm alguma informação (consulte a tabela 1).The value of ElementID after the method returns determines whether Arg1 and Arg2 contain any information (see Table 1).

Tabela 1. Informações em Arg1 e Arg2, com base na ID do elementoTable 1. Information in Arg1 and Arg2, based on the element ID

Constante de ElementIDElementID Constant* * Valor de constante * *Constant Value **Arg1Arg1Arg2Arg2
xlAxisxlAxis2121AxisIndexAxisIndexAxisTypeAxisType
xlAxisTitlexlAxisTitle1717AxisIndexAxisIndexAxisTypeAxisType
xlDisplayUnitLabelxlDisplayUnitLabel3030AxisIndexAxisIndexAxisTypeAxisType
xlMajorGridlinesxlMajorGridlines1515AxisIndexAxisIndexAxisTypeAxisType
xlMinorGridlinesxlMinorGridlines1616AxisIndexAxisIndexAxisTypeAxisType
xlPivotChartDropZonexlPivotChartDropZone3232DropZoneTypeDropZoneTypeNenhumNone
xlPivotChartFieldButtonxlPivotChartFieldButton3131DropZoneTypeDropZoneTypePivotFieldIndexPivotFieldIndex
xlDownBarsxlDownBars2020GroupIndexGroupIndexNenhumNone
xlDropLinesxlDropLines2626GroupIndexGroupIndexNenhumNone
xlHiLoLinesxlHiLoLines2525GroupIndexGroupIndexNenhumNone
xlRadarAxisLabelsxlRadarAxisLabels2727GroupIndexGroupIndexNenhumNone
xlSeriesLinesxlSeriesLines2222GroupIndexGroupIndexNenhumNone
xlUpBarsxlUpBars1818GroupIndexGroupIndexNenhumNone
xlChartAreaxlChartArea22NenhumNoneNenhumNone
xlChartTitlexlChartTitle44NenhumNoneNenhumNone
xlCornersxlCorners66NenhumNoneNenhumNone
xlDataTablexlDataTable77NenhumNoneNenhumNone
xlFloorxlFloor2323NenhumNoneNenhumNone
xlLeaderLinesxlLeaderLines2929NenhumNoneNenhumNone
xlLegendxlLegend2424NenhumNoneNenhumNone
xlNothingxlNothing2828NenhumNoneNenhumNone
xlPlotAreaxlPlotArea1919NenhumNoneNenhumNone
xlWallsxlWalls55NenhumNoneNenhumNone
xlDataLabelxlDataLabel77SeriesIndexSeriesIndexPointIndexPointIndex
xlErrorBarsxlErrorBars99SeriesIndexSeriesIndexNenhumNone
xlLegendEntryxlLegendEntry1212SeriesIndexSeriesIndexNenhumNone
xlLegendKeyxlLegendKey1313SeriesIndexSeriesIndexNenhumNone
xlSeriesxlSeries33SeriesIndexSeriesIndexPointIndexPointIndex
xlShapexlShape1414ShapeIndexShapeIndexNenhumNone
xlTrendlinexlTrendline88SeriesIndexSeriesIndexTrendLineIndexTrendLineIndex
xlXErrorBarsxlXErrorBars1010SeriesIndexSeriesIndexNenhumNone
xlYErrorBarsxlYErrorBars1111SeriesIndexSeriesIndexNenhumNone

?

A tabela 2 descreve o significado de Arg1 e Arg2 após o método retornar. Valores da coluna do argumento são da tabela 1.Table 2 describes the meaning of Arg1 and Arg2 after the method returns. Values in the Argument column are from Table 1.

Tabela 2. Significado dos dados em Arg1 e Arg2Table 2. Meaning of data in Arg1 and Arg2

ArgumentoArgumentDescriçãoDescription
AxisIndexAxisIndexEspecifica se o eixo é primário ou secundário. Pode ser uma das seguintes constantes Office.XlAxisGroup : xlPrimary ou xlSecondary.Specifies whether the axis is primary or secondary. Can be one of the following Office.XlAxisGroup constants: xlPrimary or xlSecondary.
AxisTypeAxisTypeEspecifica o tipo de eixo. Pode ser uma das seguintes constantes Office.XlAxisType : xlCategory, xlSeriesAxisou xlValue.Specifies the axis type. Can be one of the following Office.XlAxisType constants: xlCategory, xlSeriesAxis, or xlValue.
DropZoneTypeDropZoneTypeEspecifica o tipo de zona soltar: campo de linha, dados, página ou coluna. Pode ser uma das seguintes constantes Office.XlPivotFieldOrientation : xlColumnField, xlDataField, xlPageFieldou xlRowField. As constantes de campo de coluna e linha especificam os campos de série e categoria, respectivamente.Specifies the drop zone type: column, data, page, or row field. Can be one of the following Office.XlPivotFieldOrientation constants: xlColumnField, xlDataField, xlPageField, or xlRowField. The column and row field constants specify the series and category fields, respectively.
GroupIndexGroupIndexEspecifica o deslocamento dentro da coleção de Office.IMsoChart.ChartGroups para um grupo gráfico específico.Specifies the offset within the Office.IMsoChart.ChartGroups collection for a specific chart group.
PivotFieldIndexPivotFieldIndexEspecifica o deslocamento dentro da coleção de Excel.PivotFields para uma coluna específica (série), dados, página ou campo de linha (categoria). O valor é -1 se o tipo de zona de depósito for xlDataField.Specifies the offset within the Excel.PivotFields collection for a specific column (series), data, page, or row (category) field. The value is -1 if the drop zone type is xlDataField.
PointIndexPointIndexEspecifica o deslocamento dentro da coleção de Office.IMsoSeries.Points para um ponto específico dentro de uma série. Um valor ?1 indica que todos os pontos de dados estão selecionados.Specifies the offset within the Office.IMsoSeries.Points collection for a specific point within a series. A value of ?1 indicates that all data points are selected.
SeriesIndexSeriesIndexEspecifica o deslocamento dentro do Office.IMsoChart.SeriesCollection para uma série específica.Specifies the offset within the Office.IMsoChart.SeriesCollection for a specific series.
ShapeIndexShapeIndexEspecifica o deslocamento dentro da coleção Shapes para uma forma específica.Specifies the offset within the Shapes collection for a specific shape.
TrendlineIndexTrendlineIndexEspecifica o deslocamento dentro da coleção de Office.IMsoSeries.Trendlines para uma linha de tendência específica dentro de uma série.Specifies the offset within the Office.IMsoSeries.Trendlines collection for a specific trendline within a series.

ExemploExample

O exemplo a seguir obtém as informações do elemento de gráfico de ponto (100, 100) no gráfico. Por exemplo, se o ponto estiver dentro da área de plotagem, saída no painel imediato é idNum: 19, a: 0, b: 0. Com as informações na tabela 1, xlPlotArea = 19.The following example gets the chart element information for point (100, 100) in the chart. For example, if the point is within the plot area, output in the Immediate pane is idNum: 19, a: 0, b: 0. From the information in Table 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

Veja tambémSee also

Outros recursosOther resources

Objeto ChartChart Object

© 2018 Microsoft