WorksheetBase.ChartObjects (Método)
Obtiene un objeto que representa un único gráfico incrustado (un objeto Microsoft.Office.Interop.Excel.ChartObject) o una colección de todos los gráficos incrustados (una colección Microsoft.Office.Interop.Excel.ChartObjects) en la hoja de cálculo.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel.v4.0.Utilities (en Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Sintaxis
'Declaración
Public Function ChartObjects ( _
index As Object _
) As Object
public Object ChartObjects(
Object index
)
Parámetros
- index
Tipo: System.Object
El nombre o número del gráfico.Este argumento puede ser una matriz, para especificar más de un gráfico.
Valor devuelto
Tipo: System.Object
Objeto que representa un único gráfico incrustado (un objeto Microsoft.Office.Interop.Excel.ChartObject) o una colección de todos los gráficos incrustados (una colección Microsoft.Office.Interop.Excel.ChartObjects) en la hoja de cálculo.
Comentarios
Este método no es equivalente a la propiedad Charts.Este método devuelve gráficos incrustados; la propiedad Charts devuelve hojas de gráficos.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
El ejemplo de código siguiente muestra cómo utilizar el método ChartObjects para obtener la colección de gráficos incrustados y un gráfico incrustado único.En primer lugar, el ejemplo utiliza el método ChartObjects para obtener la colección Microsoft.Office.Interop.Excel.ChartObjects de la hoja de cálculo actual y crear un nuevo objeto Microsoft.Office.Interop.Excel.ChartObject.Después de dar formato al nuevo objeto Microsoft.Office.Interop.Excel.ChartObject y darle un nombre a Microsoft.Office.Interop.Excel.ChartObject, el ejemplo utiliza el método ChartObjects para obtener el nuevo objeto Microsoft.Office.Interop.Excel.ChartObject (indizado por nombre) y muestra una vista previa de impresión del gráfico.
Se trata de un ejemplo para una personalización en el nivel del documento.
Private Sub CreateAndPreviewChart()
Me.Range("A1", "A3").Value2 = 11
Me.Range("B1", "B3").Value2 = 55
Dim ChartObjects1 As Excel.ChartObjects = _
CType(Me.ChartObjects(), Excel.ChartObjects)
Dim chartObject1 As Excel.ChartObject = _
ChartObjects1.Add(100, 20, 400, 250)
chartObject1.Chart.ChartWizard(Me.Range("A1", "B3"), _
Excel.XlChartType.xl3DColumn, Title:="New Chart")
chartObject1.Name = "NewChartObject"
Dim chartObject2 As Excel.ChartObject = _
CType(Me.ChartObjects("NewChartObject"), Excel.ChartObject)
chartObject2.Chart.PrintPreview(False)
End Sub
private void CreateAndPreviewChart()
{
this.Range["A1", "A3"].Value2 = 11;
this.Range["B1", "B3"].Value2 = 55;
Excel.ChartObjects ChartObjects1 =
(Excel.ChartObjects)this.ChartObjects();
Excel.ChartObject chartObject1 = ChartObjects1.Add(100, 20, 400, 250);
chartObject1.Chart.ChartWizard(this.Range["A1", "B3"],
Excel.XlChartType.xl3DColumn, "New Chart");
chartObject1.Name = "NewChartObject";
Excel.ChartObject chartObject2 =
(Excel.ChartObject)this.ChartObjects("NewChartObject");
chartObject2.Chart.PrintPreview(false);
}
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.