Método Chart.GetChartElement

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.

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

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