Compartir a través de


ControlCollection.AddChart (Método) (Double, Double, Double, Double, String)

Agrega a la hoja de cálculo un nuevo control Chart con el tamaño y en la ubicación especificados.

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

Sintaxis

'Declaración
Function AddChart ( _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As Chart
Chart AddChart(
    double left,
    double top,
    double width,
    double height,
    string name
)

Parámetros

  • left
    Tipo: System.Double
    Distancia, expresada en puntos, entre el borde izquierdo del control y el borde izquierdo de la hoja de cálculo.
  • top
    Tipo: System.Double
    Distancia, expresada en puntos, entre el borde superior del control y el borde superior de la hoja de cálculo.
  • width
    Tipo: System.Double
    Ancho del control, expresado en puntos.
  • height
    Tipo: System.Double
    Alto del control, expresado en puntos.

Valor devuelto

Tipo: Microsoft.Office.Tools.Excel.Chart
Control Chart agregado a la instancia del objeto ControlCollection.

Excepciones

Excepción Condición
ArgumentNullException

El argumento de nombre es nullreferencia null (Nothing en Visual Basic) o tiene longitud cero.

ControlNameAlreadyExistsException

Ya existe un control con el mismo nombre en la instancia de ControlCollection.

Comentarios

El método AddChart permite agregar controles Chart al final de ControlCollection. Para quitar un control Chart agregado previamente mediante programación, utilice el método Remove.

Ejemplos

En el siguiente ejemplo de código se inserta el número 16 en las celdas E1 hasta E3, y el número 24 en las celdas F1 hasta F3. A continuación, mediante el código se crea un control Chart hacia la parte superior de la hoja de cálculo y se pasan las celdas E1 hasta F3 al método SetSourceData para rellenar el gráfico con datos.

Private Sub ExcelAddChart()
    Me.Range("E1", "E3").Value2 = 16
    Me.Range("F1", "F3").Value2 = 24

    Dim Chart1 As Microsoft.Office.Tools.Excel. _
        Chart = Me.Controls.AddChart(0, 0, 130, _
        130, "Chart1")

    Chart1.SetSourceData(Me.Range("E1", "F3"), _
        Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType. _
        xlColumnClustered

End Sub
private void ExcelAddChart()
{
    this.Range["E1", "E3"].Value2 = 16;
    this.Range["F1", "F3"].Value2 = 24;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(0, 0, 130, 130, "chart1");

    chart1.SetSourceData(this.Range["E1", "F3"], Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xlColumnClustered;
}

Seguridad de .NET Framework

Vea también

Referencia

ControlCollection Interfaz

AddChart (Sobrecarga)

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