Chart.GetChartElement (Método)

Artículo
05/15/2013

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	None
xlPivotChartFieldButton	DropZoneType	PivotFieldIndex
xlDownBars	GroupIndex	None
xlDropLines	GroupIndex	None
xlHiLoLines	GroupIndex	None
xlRadarAxisLabels	GroupIndex	None
xlSeriesLines	GroupIndex	None
xlUpBars	GroupIndex	None
xlChartArea	None	None
xlChartTitle	None	None
xlCorners	None	None
xlDataTable	None	None
xlFloor	None	None
xlLeaderLines	None	None
xlLegend	None	None
xlNothing	None	None
xlPlotArea	None	None
xlWalls	None	None
xlDataLabel	SeriesIndex	PointIndex
xlErrorBars	SeriesIndex	None
xlLegendEntry	SeriesIndex	None
xlLegendKey	SeriesIndex	None
xlSeries	SeriesIndex	PointIndex
xlShape	ShapeIndex	None
xlTrendline	SeriesIndex	TrendLineIndex
xlXErrorBars	SeriesIndex	None
xlYErrorBars	SeriesIndex	None

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