Método ChartSheetBase.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.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
Public Sub GetChartElement ( _
    x As Integer, _
    y As Integer, _
    ByRef elementID As Integer, _
    ByRef arg1 As Integer, _
    ByRef arg2 As Integer _
)

public 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 usa o método de GetChartElement para exibir o elemento do gráfico quando um usuário clica no gráfico.

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

    Me.SetSourceData(Globals.Sheet1.Range("A1", "B5"), _
        Excel.XlRowCol.xlColumns)
    Me.ChartType = Excel.XlChartType.xlColumnClustered
End Sub

Sub ChartSheet_MouseDown(ByVal Button As Integer, ByVal Shift As Integer, _
    ByVal x As Integer, ByVal y As Integer) Handles Me.MouseDown

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

    Me.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 void DisplayChartElement()
{
    Globals.Sheet1.Range["A1", "A5"].Value2 = 22;
    Globals.Sheet1.Range["B1", "B5"].Value2 = 55;

    this.SetSourceData(Globals.Sheet1.Range["A1", "B5"],
        Excel.XlRowCol.xlColumns);
    this.ChartType = Excel.XlChartType.xlColumnClustered;

    this.MouseDown +=
        new Excel.ChartEvents_MouseDownEventHandler(ChartSheet_MouseDown);
}

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

    this.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

ChartSheetBase Classe

Namespace Microsoft.Office.Tools.Excel