ControlCollection.AddChart (Método) (Range, String)
Agrega a la hoja de cálculo un nuevo control Chart en el rango especificado.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
Function AddChart ( _
range As Range, _
name As String _
) As Chart
Chart AddChart(
Range range,
string name
)
Parámetros
- range
Tipo: Microsoft.Office.Interop.Excel.Range
Objeto Range que proporciona los límites del control.
- name
Tipo: System.String
Nombre del control que puede utilizarse para indizar el control en la instancia de ControlCollection.
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 o rango es nullreferencia null (Nothing en Visual Basic), o el argumento de nombre tiene longitud cero. |
| ControlNameAlreadyExistsException | Ya existe un control con el mismo nombre en la instancia de ControlCollection. |
| InvalidRangeException | El intervalo especificado no es válido. No pueden utilizarse rangos multiárea. El rango debe estar en la misma hoja de cálculo que 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 para las celdas A1 hasta C8 y se pasan las celdas E1 hasta F3 al método SetSourceData para rellenar el gráfico con datos.
Private Sub ExcelAddRangeChart()
Me.Range("E1", "E3").Value2 = 16
Me.Range("F1", "F3").Value2 = 24
Dim Chart1 As Microsoft.Office.Tools.Excel.Chart _
= Me.Controls.AddChart(Me.Range("A1", "C8"), _
"Chart1")
Chart1.SetSourceData(Me.Range("E1", "F5"), _
Excel.XlRowCol.xlColumns)
Chart1.ChartType = Excel.XlChartType. _
xlColumnClustered
End Sub
private void ExcelAddRangeChart()
{
this.Range["E1", "E3"].Value2 = 16;
this.Range["F1", "F3"].Value2 = 24;
Microsoft.Office.Tools.Excel.Chart chart1 =
this.Controls.AddChart(this.Range["A1", "C8"], "Chart1");
chart1.SetSourceData(this.Range["E1", "F5"], 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.