Método ChartSheet.GetChartElement

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.

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

Exemplos

O seguinte exemplo de código usa a GetChartElement método para exibir o elemento 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

ChartSheet Interface

Namespace Microsoft.Office.Tools.Excel