Chart.GetChartElement (Método)

Artículo
08/10/2011

Obtiene información acerca del elemento del gráfico en las coordenadas X e Y especificadas.

Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)

Sintaxis

'Declaración
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
Coordenada X del elemento del gráfico.

y
Tipo: System.Int32
Coordenada Y del elemento del gráfico.

ElementID
Tipo: System.Int32%
Cuando el método devuelve un resultado, este argumento contiene el valor XlChartItem del elemento del gráfico en las coordenadas especificadas.Para obtener más información, vea la sección "Comentarios".

Arg1
Tipo: System.Int32%
Cuando el método devuelve un resultado, este argumento contiene información relacionada con el elemento del gráfico.Para obtener más información, vea la sección "Comentarios".

Arg2
Tipo: System.Int32%
Cuando el método devuelve un resultado, este argumento contiene información relacionada con el elemento del gráfico.Para obtener más información, vea la sección "Comentarios".

Comentarios

Este método es excepcional porque sólo se especifican valores para los dos primeros argumentos. Microsoft Office Excel rellena los otros argumentos y el código debe examinar esos valores cuando el método devuelve un resultado.

El valor de ElementID después de que el método devuelva un resultado determina si Arg1 y Arg2 contienen información, tal como se muestra en la tabla siguiente.

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

En la siguiente tabla se describe el significado de Arg1 y Arg2 después de que el método devuelva un resultado.

Argumento	Descripción
axisIndex	Especifica si el eje es principal o secundario. Puede ser una de las constantes XlAxisGroup siguientes: xlPrimary o xlSecondary.
AxisType	Especifica el tipo de eje. Puede ser una de las siguientes constantes XlAxisType: xlCategory, xlSeriesAxis o xlValue.
DropZoneType	Especifica el tipo de zona de colocación: campo de fila, columna, datos o página. Puede ser una de las siguientes constantes de XlPivotFieldOrientation: xlColumnField, xlDataField, xlPageField o xlRowField. Las constantes de campo de fila y columna especifican los campos de serie y categoría, respectivamente.
GroupIndex	Especifica el desplazamiento dentro de la colección ChartGroups para un grupo de gráficos determinado.
PivotFieldIndex	Especifica el desplazamiento dentro de la colección PivotFields para un determinado campo de columna (serie), datos, página o fila (categoría). -1 si el tipo de zona de colocación es xlDataField.
PointIndex	Especifica el desplazamiento dentro de la colección Points para un punto determinado en una serie. Un valor de - 1 indica que están seleccionados todos los puntos de datos.
SeriesIndex	Especifica el desplazamiento dentro de la colección Series para una serie determinada.
ShapeIndex	Especifica el desplazamiento dentro de la colección Shapes para una forma determinada.
TrendlineIndex	Especifica el desplazamiento dentro de la colección Trendlines para una línea de tendencia determinada dentro de una serie.

Ejemplos

El ejemplo de código siguiente crea un Microsoft.Office.Tools.Excel.Chart y, a continuación, utiliza el método GetChartElement para presentar el elemento del gráfico cuando un usuario hace clic en el gráfico.

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

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

Chart Interfaz

Microsoft.Office.Tools.Excel (Espacio de nombres)

Compartir a través de