Método Chart.GetChartElement

Artigo
05/21/2013

Obtém informações sobre o elemento do 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 específicas.Para obter mais informações, consulte a seção “comentários”.

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

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

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 após o método retornará determinar se Arg1 e Arg2 contêm informações, como mostrado na tabela.

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 da linha especifica os campos de série de categoria e, respectivamente.
GroupIndex	Especifica o deslocamento na coleção de ChartGroups para um determinado grupo de gráfico.
PivotFieldIndex	Especifica o deslocamento na 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 na 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 na coleção de Series para uma série específica.
ShapeIndex	Especifica o deslocamento na coleção de Shapes para uma maneira específica.
TrendlineIndex	Especifica o deslocamento na 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 do 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

Compartilhar via