Método Chart.GetChartElement

Artigo
01/09/2014

Obtém informações sobre o elemento de gráfico especificadas em 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 de elemento gráfico.

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

ElementID
Tipo: System.Int32%
Quando o método retorna, esse argumento contém o valor de XlChartItem de elemento gráfico nas coordenadas especificado.Para obter mais informações, consulte que os “comentários” seccionam.

Arg1
Tipo: System.Int32%
Quando o método retorna, esse argumento contém informações acrescentadas para o elemento de gráfico.Para obter mais informações, consulte que os “comentários” seccionam.

Arg2
Tipo: System.Int32%
Quando o método retorna, esse argumento contém informações acrescentadas para o elemento de gráfico.Para obter mais informações, consulte que os “comentários” seccionam.

Comentários

Este método é incomum que você especificar valores para somente os primeiros dois argumentos. Microsoft Office Excel preenche os outros argumentos, e seu código deve examinar os valores quando o método retorna.

O valor de ElementID depois que retorna o método determinar se Arg1 e Arg2 contém algumas informações, conforme 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	Nenhum
xlPivotChartFieldButton	DropZoneType	PivotFieldIndex
xlDownBars	GroupIndex	Nenhum
xlDropLines	GroupIndex	Nenhum
xlHiLoLines	GroupIndex	Nenhum
xlRadarAxisLabels	GroupIndex	Nenhum
xlSeriesLines	GroupIndex	Nenhum
xlUpBars	GroupIndex	Nenhum
xlChartArea	Nenhum	Nenhum
xlChartTitle	Nenhum	Nenhum
xlCorners	Nenhum	Nenhum
xlDataTable	Nenhum	Nenhum
xlFloor	Nenhum	Nenhum
xlLeaderLines	Nenhum	Nenhum
xlLegend	Nenhum	Nenhum
xlNothing	Nenhum	Nenhum
xlPlotArea	Nenhum	Nenhum
xlWalls	Nenhum	Nenhum
xlDataLabel	SeriesIndex	PointIndex
xlErrorBars	SeriesIndex	Nenhum
xlLegendEntry	SeriesIndex	Nenhum
xlLegendKey	SeriesIndex	Nenhum
xlSeries	SeriesIndex	PointIndex
xlShape	ShapeIndex	Nenhum
xlTrendline	SeriesIndex	TrendLineIndex
xlXErrorBars	SeriesIndex	Nenhum
xlYErrorBars	SeriesIndex	Nenhum

A tabela a seguir descreve o significado de Arg1 e de Arg2 depois que o método retorna.

Argumento	Descrição
AxisIndex	Especifica se o eixo é primária ou sub. Pode ser uma das seguintes constantes de XlAxisGroup : xlPrimary ou xlSecondary.
AxisType	Especifica o tipo do eixo. Pode ser uma das seguintes constantes de XlAxisType : xlCategory, xlSeriesAxis, ou xlValue.
DropZoneType	Especifica o tipo da área para arrastar e soltar: coluna, dados, página, ou campo da linha. Pode ser uma das seguintes constantes de XlPivotFieldOrientation : xlColumnField, xlDataField, xlPageField, ou xlRowField. Constantes de coluna e do campo de linha especificam os campos de cadeia e de categoria, respectivamente.
GroupIndex	Especifica o deslocamento dentro da coleção de ChartGroups para um determinado grupo de gráfico.
PivotFieldIndex	Especifica o deslocamento dentro da coleção de PivotFields para uma coluna específica (série), dados, página, ou campo de linha (categoria). -1 se o tipo da área para arrastar e soltar é xlDataField.
PointIndex	Especifica o deslocamento dentro da coleção de Points para um ponto específico em uma série. Um valor de – 1 indica que os pontos de dados são selecionados.
SeriesIndex	Especifica o deslocamento dentro da coleção de Series para uma série específica.
ShapeIndex	Especifica o deslocamento dentro da coleção de Shapes para uma maneira específica.
TrendlineIndex	Especifica o deslocamento dentro da coleção de Trendlines para um trendline específico em uma série.

Exemplos

O exemplo de código a seguir cria Microsoft.Office.Tools.Excel.Chart e usa o método de GetChartElement para exibir o elemento de 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ável.

Consulte também

Referência

Chart Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via