Método Chart.GetChartElement

Artigo
08/01/2011

Deixa as informações sobre o elemento gráfico no especificado coordenadas x e Y.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Sub GetChartElement ( _
    x As Integer, _
    y As Integer, _
    ByRef ElementID As Integer, _
    ByRef Arg1 As Integer, _
    ByRef Arg2 As Integer _
)

void GetChartElement(
    int x,
    int y,
    ref int ElementID,
    ref int Arg1,
    ref int Arg2
)

Parâmetros

x
Tipo: System.Int32
A coordenada x do elemento gráfico.

y
Tipo: System.Int32
A coordenada y do elemento gráfico.

ElementID
Tipo: System.Int32%
Quando o método retorna, esse argumento contém o XlChartItem o valor do elemento gráfico em coordenadas especificadas.Para obter mais informações, consulte "Comentários" seção.

Arg1
Tipo: System.Int32%
Quando o método retorna, esse argumento contém informações relacionadas ao elemento gráfico.Para obter mais informações, consulte "Comentários" seção.

Arg2
Tipo: System.Int32%
Quando o método retorna, esse argumento contém informações relacionadas ao elemento gráfico.Para obter mais informações, consulte "Comentários" seção.

Comentários

Esse método é incomum que você especificar valores para os dois primeiros de argumentos. Excel de Microsoft Office preenche os outros argumentos e seu código deverá examinar esses valores quando o método retorna.

O valor de ElementID após o método retornar determina se Arg1 e Arg2 contêm alguma informação, como mostrado na tabela a seguir.

ElementID	Arg1	Arg2
xlAxis	AxisIndex	AxisType
xlAxisTitle	AxisIndex	AxisType
xlDisplayUnitLabel	AxisIndex	AxisType
xlMajorGridlines	AxisIndex	AxisType
xlMinorGridlines	AxisIndex	AxisType
xlPivotChartDropZone	DropZoneType	None
xlPivotChartFieldButton	DropZoneType	PivotFieldIndex
xlDownBars	GroupIndex	None
xlDropLines	GroupIndex	None
xlHiLoLines	GroupIndex	None
xlRadarAxisLabels	GroupIndex	None
xlSeriesLines	GroupIndex	None
xlUpBars	GroupIndex	None
xlChartArea	None	None
xlChartTitle	None	None
xlCorners	None	None
xlDataTable	None	None
xlFloor	None	None
xlLeaderLines	None	None
xlLegend	None	None
xlNothing	None	None
xlPlotArea	None	None
xlWalls	None	None
xlDataLabel	SeriesIndex	PointIndex
xlErrorBars	SeriesIndex	None
xlLegendEntry	SeriesIndex	None
xlLegendKey	SeriesIndex	None
xlSeries	SeriesIndex	PointIndex
xlShape	ShapeIndex	None
xlTrendline	SeriesIndex	TrendLineIndex
xlXErrorBars	SeriesIndex	None
xlYErrorBars	SeriesIndex	None

A tabela a seguir descreve o significado de Arg1 e Arg2 após o método retorna.

Argument	Description
AxisIndex	Especifica se o eixo é primário ou secundário. Pode ser uma das seguintes XlAxisGroup constantes: xlPrimary or xlSecondary.
AxisType	Especifica o tipo de eixo. Pode ser uma das seguintes XlAxisType constantes: xlCategory, xlSeriesAxis, or xlValue.
DropZoneType	Especifica o tipo de zona de soltar: coluna, dados, página ou campo de linha. Pode ser uma das seguintes XlPivotFieldOrientation constantes: xlColumnField, xlDataField, xlPageField, or xlRowField. As constantes de campo de coluna e linha especificam os campos de série e categoria, respectivamente.
GroupIndex	Especifica o deslocamento dentro da ChartGroups a coleção para um grupo gráfico específico.
PivotFieldIndex	Especifica o deslocamento dentro da PivotFields coleção para uma coluna específica (série), dados, página ou campo de linha (categoria). -1 se o tipo de zona de soltar é xlDataField.
PointIndex	Especifica o deslocamento dentro da Points coleção 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 da Series coleção para uma série específica.
ShapeIndex	Especifica o deslocamento dentro da Shapes coleção para uma forma específica.
TrendlineIndex	Especifica o deslocamento dentro da Trendlines coleção para uma linha de tendência específica dentro de uma série.

Exemplos

O exemplo de código a seguir cria um Microsoft.Office.Tools.Excel.Chart e, em seguida, usa o GetChartElement método para exibir o elemento gráfico quando um usuário clica no gráfico.

WithEvents elementChart As Microsoft.Office.Tools.Excel.Chart

Private Sub DisplayChartElement()
    Globals.Sheet1.Range("A1", "A5").Value2 = 22
    Globals.Sheet1.Range("B1", "B5").Value2 = 55

    elementChart = Me.Controls.AddChart(Me.Range("D2", "H12"), _
        "elementChart")
    elementChart.SetSourceData(Globals.Sheet1.Range("A1", "B5"), _
        Excel.XlRowCol.xlColumns)
    elementChart.ChartType = Excel.XlChartType.xl3DColumn
End Sub

Sub elementChart_MouseDownHandler(ByVal Button As Integer, ByVal Shift As Integer, _
    ByVal x As Integer, ByVal y As Integer) Handles elementChart.MouseDown

    Dim elementID As Integer = 0
    Dim arg1 As Integer = 0
    Dim arg2 As Integer = 0

    elementChart.GetChartElement(x, y, elementID, arg1, arg2)

    MsgBox("Chart element is: " & CType(elementID, Excel.XlChartItem).ToString() _
            & Constants.vbNewLine & "arg1 is: " & arg1.ToString() _
            & Constants.vbNewLine & "arg2 is: " & arg2.ToString())
End Sub

private Microsoft.Office.Tools.Excel.Chart elementChart;

private void DisplayChartElement()
{
    this.Range["A1", "A5"].Value2 = 22;
    this.Range["B1", "B5"].Value2 = 55;

    elementChart = this.Controls.AddChart(this.Range["D2", "H12"],
        "elementChart");

    elementChart.SetSourceData(this.Range["A1", "B5"],
        Excel.XlRowCol.xlColumns);
    elementChart.ChartType = Excel.XlChartType.xl3DColumn;
    elementChart.MouseDown +=
        new Excel.ChartEvents_MouseDownEventHandler(elementChart_MouseDown);
}

void elementChart_MouseDown(int Button, int Shift, int x, int y)
{
    Int32 elementID = 0;
    Int32 arg1 = 0;
    Int32 arg2 = 0;

    elementChart.GetChartElement(x, y, ref elementID, ref arg1, ref arg2);

    MessageBox.Show("Chart element is: " + ((Excel.XlChartItem)elementID).ToString()
        + "\n arg1 is: " + arg1.ToString() + "\n arg2 is: " + arg2.ToString());
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Chart Interface

Namespace Microsoft.Office.Tools.Excel

Partilhar via