ChartSheet.GetChartElement 方法

取得在指定的 X 和 Y 座標上的圖表項目相關資訊。

命名空間：  Microsoft.Office.Tools.Excel
組件：   Microsoft.Office.Tools.Excel.v4.0.Utilities (在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中)
  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
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
)

參數

• x
  型別：System.Int32
  圖表項目的 X 座標。

• y
  型別：System.Int32
  圖表項目的 Y 座標。

• ElementID
  型別：System.Int32%
  當方法傳回時，這個引數會包含指定座標上圖表項目的 XlChartItem 值。如需詳細資訊，請參閱＜備註＞一節。

• Arg1
  型別：System.Int32%
  當方法傳回時，這個引數會包含與圖表項目有關的資訊。如需詳細資訊，請參閱＜備註＞一節。

• Arg2
  型別：System.Int32%
  當方法傳回時，這個引數會包含與圖表項目有關的資訊。如需詳細資訊，請參閱＜備註＞一節。

備註

這個方法的特殊之處在於您只會指定前面兩個引數的值。 Microsoft Office Excel 會填入其他引數，而您的程式碼應在方法傳回時檢查這些值。

方法傳回後，ElementID 的值會決定 Arg1 和 Arg2 是否包含任何資訊，如下表所示。

下表說明方法傳回後，Arg1 和 Arg2 所代表的意義。

範例

下列程式碼範例使用 GetChartElement 方法顯示當使用者按一下圖表時會出現圖表項目。

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());
}

.NET Framework 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

ChartSheet 介面

Microsoft.Office.Tools.Excel 命名空間