Chart.GetChartElement メソッド

[アーティクル]
05/14/2013

指定した 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	ChartGroups コレクション内での、指定したグラフグループのオフセットを示します。
PivotFieldIndex	PivotFields コレクション内での、指定した列 (系列)、データ、ページ、または行 (項目) フィールドのオフセットを示します。ドロップエリアの種類が xlDataField の場合は -1 です。
PointIndex	Points コレクション内での、系列内の指定した要素のオフセットを示します。値 –1 は、すべてのデータ要素が選択されていることを示します。
SeriesIndex	Series コレクション内での、指定した系列のオフセットを示します。
ShapeIndex	Shapes コレクション内での、指定した図形のオフセットを示します。
TrendlineIndex	Trendlines コレクション内での、系列内の指定した近似曲線のオフセットを示します。

例

次のコード例は、Microsoft.Office.Tools.Excel.Chart を作成し、次に GetChartElement メソッドを使用してユーザーがグラフをクリックしたときにグラフ要素を表示します。

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

.NET Framework セキュリティ

直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

次の方法で共有

Chart.GetChartElement メソッド

構文

パラメーター

解説

例

.NET Framework セキュリティ

参照

関連項目

その他のリソース