Chart.GetChartElement メソッド (Microsoft.Office.Tools.Excel)

GetChartElement メソッド

すべて縮小

言語フィルタ

このページは次のバージョンについて記述しています。

Microsoft Visual Studio 2005/.NET Framework 2.0

その他のバージョンについては、以下の情報を参照してください。

Excel オブジェクトモデルのリファレンス (Visual Studio Tools for Office)

Chart.GetChartElement メソッド

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

名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (microsoft.office.tools.excel.dll 内)

構文

Visual Basic (宣言)

Public Sub GetChartElement ( _
    x As Integer, _
    y As Integer, _
    ByRef ElementID As Integer, _
    ByRef Arg1 As Integer, _
    ByRef Arg2 As Integer _
)

Visual Basic (使用法)

Dim instance As Chart
Dim x As Integer
Dim y As Integer
Dim ElementID As Integer
Dim Arg1 As Integer
Dim Arg2 As Integer

instance.GetChartElement(x, y, ElementID, Arg1, Arg2)

public void GetChartElement (
    int x,
    int y,
    ref int ElementID,
    ref int Arg1,
    ref int Arg2
)

パラメータ

x: グラフ要素の X 座標です。

y: グラフ要素の Y 座標です。

ElementID: このメソッドから制御が戻ったとき、この引数には、指定した座標のグラフ要素の XlChartItem 値が格納されています。詳細については、「解説」を参照してください。

Arg1: メソッドから制御が戻ったとき、この引数には、グラフ要素に関連する情報が格納されています。詳細については、「解説」を参照してください。

Arg2: メソッドから制御が戻ったとき、この引数には、グラフ要素に関連する情報が格納されています。詳細については、「解説」を参照してください。

解説

このメソッドは通常とは異なっており、呼び出し側で値を指定する引数は最初の 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	なし	なし
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 コレクション内での、系列内の指定した近似曲線のオフセットを示します。

使用要件

プロジェクトで ExcelLocale1033Attribute 属性が true (既定) に設定されている場合、GetChartElement は機能しません。ExcelLocale1033Attribute 属性が true の場合は、次の手順を実行する必要があります。

Microsoft.Office.Tools.Excel.Chart ホストコントロールではなく、基になる Microsoft.Office.Interop.Excel.Chart のGetChartElement メソッドを呼び出す必要があります。
GetChartElement を呼び出す前に、基になる Microsoft.Office.Interop.Excel.Chart オブジェクトに対して Unwrap メソッドを使用する必要があります。

Unwrap は、ロケール ID 1033 を渡す代わりに、現在のスレッドのロケール ID を Excel オブジェクトモデルに渡すようにこのオブジェクトを変更します。

このトピックのコード例では、ExcelLocale1033Attribute 属性が true の場合に GetChartElement を使用する方法を示します。ExcelLocale1033Attribute および Unwrap メソッドの詳細については、「さまざまな地域設定を使用した Excel のデータの書式設定」を参照してください。

使用例

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

メモ
このコード例では、ExcelLocale1033Attribute 属性が true (既定) であることを前提としています。ExcelLocale1033Attribute 属性が false の場合は、Microsoft.Office.Tools.Excel.Chart ホストコントロールの GetChartElement メソッドを呼び出すことができます。Unwrap メソッドを使用する必要はありません。詳細については、このトピックの「解説」を参照してください。

メモ

このコード例では、ExcelLocale1033Attribute 属性が true (既定) であることを前提としています。ExcelLocale1033Attribute 属性が false の場合は、Microsoft.Office.Tools.Excel.Chart ホストコントロールの GetChartElement メソッドを呼び出すことができます。Unwrap メソッドを使用する必要はありません。詳細については、このトピックの「解説」を参照してください。

Visual Basic

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

    Dim innerChart As Excel.Chart = CType( _
        Microsoft.Office.Tools.Excel.ExcelLocale1033Proxy.Unwrap( _
        elementChart.InnerObject), Excel.Chart)

    innerChart.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;

    Excel.Chart innerChart = (Excel.Chart)Microsoft.Office.Tools.
        Excel.ExcelLocale1033Proxy.Unwrap(elementChart.InnerObject);

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

参照

パラメータ

使用要件

関連項目