ChartSheet.GetChartElement メソッド

[アーティクル]
08/09/2011

指定した X 座標および Y 座標のグラフ要素の情報を取得します。

名前空間: Microsoft.Office.Tools.Excel
アセンブリ: 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%
メソッドから制御が戻ったとき、この引数には、グラフ要素に関連する情報が格納されています。詳細については、「解説」を参照してください。

解説

このメソッドは通常とは異なっており、呼び出し側で値を指定する引数は最初の 2 つだけです。他の引数は Microsoft Office Excel が値を設定します。メソッドから制御が戻ったときには、呼び出し側のコードでそれらの値をチェックする必要があります。

Arg1 と Arg2 に情報が含まれているかどうかは、メソッドから制御が戻った後の ElementID の値に応じて、次の表のように決定されます。

ElementID	Arg1	Arg2
xlAxis	AxisIndex	AxisType
xlAxisTitle	AxisIndex	AxisType
xlDisplayUnitLabel	AxisIndex	AxisType
xlMajorGridlines	AxisIndex	AxisType
xlMinorGridlines	AxisIndex	AxisType
xlPivotChartDropZone	DropZoneType	[なし]
xlPivotChartFieldButton	DropZoneType	PivotFieldIndex
xlDownBars	GroupIndex	[なし]
xlDropLines	GroupIndex	[なし]
xlHiLoLines	GroupIndex	[なし]
xlRadarAxisLabels	GroupIndex	[なし]
xlSeriesLines	GroupIndex	[なし]
xlUpBars	GroupIndex	[なし]
xlChartArea	[なし]	[なし]
xlChartTitle	[なし]	[なし]
xlCorners	[なし]	[なし]
xlDataTable	[なし]	[なし]
xlFloor	[なし]	[なし]
xlLeaderLines	[なし]	[なし]
xlLegend	[なし]	[なし]
xlNothing	[なし]	[なし]
xlPlotArea	[なし]	[なし]
xlWalls	[なし]	[なし]
xlDataLabel	SeriesIndex	PointIndex
xlErrorBars	SeriesIndex	[なし]
xlLegendEntry	SeriesIndex	[なし]
xlLegendKey	SeriesIndex	[なし]
xlSeries	SeriesIndex	PointIndex
xlShape	ShapeIndex	[なし]
xlTrendline	SeriesIndex	TrendLineIndex
xlXErrorBars	SeriesIndex	[なし]
xlYErrorBars	SeriesIndex	[なし]

次の表は、メソッドから制御が戻った後の Arg1 と Arg2 の意味を示します。

引数	説明
AxisIndex	軸が主軸と第 2 軸のどちらであるかを示します。 XlAxisGroup 定数 (xlPrimary または xlSecondary) のどちらかです。
AxisType	軸の種類を示します。 XlAxisType 定数 (xlCategory、xlSeriesAxis、または xlValue) のいずれかです。
DropZoneType	ドロップエリアの種類が、列、データ、ページ、行フィールドのいずれであるかを示します。 XlPivotFieldOrientation 定数 (xlColumnField、xlDataField、xlPageField、または xlRowField) のいずれかです。列フィールドおよび行フィールドの両定数はそれぞれ、系列フィールドおよび項目フィールドを示します。
GroupIndex	Microsoft.Office.Interop.Excel.ChartGroups コレクション内での、指定したグラフグループのオフセットを示します。
PivotFieldIndex	T:Microsoft.Office.Interop.Excel.PivotFields コレクション内での、指定した列 (系列)、データ、ページ、または行 (項目) フィールドのオフセットを示します。ドロップエリアの種類が xlDataField の場合は -1 です。
PointIndex	Points コレクション内での、系列内の指定した要素のオフセットを示します。値 –1 は、すべてのデータ要素が選択されていることを示します。
SeriesIndex	Series コレクション内での、指定した系列のオフセットを示します。
ShapeIndex	Shapes コレクション内での、指定した図形のオフセットを示します。
TrendlineIndex	Trendlines コレクション内での、系列内の指定した近似曲線のオフセットを示します。

例

次のコード例は、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 名前空間

次の方法で共有

ChartSheet.GetChartElement メソッド

構文

パラメーター

解説

例

.NET Framework セキュリティ

参照

参照

その他のリソース