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.
- name
Tipo: System.String
Nombre del control.
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
- 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.