Método WorksheetBase.ChartObjects
Obtém um objeto representando um único gráfico incorporado (um Microsoft.Office.Interop.Excel.ChartObject) ou uma coleção de todos os gráficos incorporados (um Microsoft.Office.Interop.Excel.ChartObjects) na planilha.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Sintaxe
'Declaração
Public Function ChartObjects ( _
index As Object _
) As Object
public Object ChartObjects(
Object index
)
Parâmetros
- index
Tipo: System.Object
O nome ou número do gráfico.Esse argumento pode ser uma matriz, para especificar mais de um gráfico.
Valor de retorno
Tipo: System.Object
Um objeto que representa tanto um único gráfico incorporado (um Microsoft.Office.Interop.Excel.ChartObject) ou uma coleção de todos os gráficos incorporados (um Microsoft.Office.Interop.Excel.ChartObjects) na planilha.
Comentários
Esse método não é equivalente a Charts propriedade. Esse método retorna gráficos incorporados; o Charts propriedade retorna folhas de gráfico.
Optional Parameters
Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.
Exemplos
O exemplo de código a seguir demonstra como usar o ChartObjects método para obter a coleção de gráficos incorporados e um único gráfico incorporado. O exemplo usa primeiro o ChartObjects método para obter o Microsoft.Office.Interop.Excel.ChartObjects a coleção da planilha atual e criar um novo Microsoft.Office.Interop.Excel.ChartObject. Depois de formatar o novo Microsoft.Office.Interop.Excel.ChartObject e dando o Microsoft.Office.Interop.Excel.ChartObject um nome, o exemplo usa o ChartObjects método para obter o novo Microsoft.Office.Interop.Excel.ChartObject (indexados pelo seu nome) e exibe uma visualização de impressão do gráfico.
Este exemplo é para uma personalização em nível de 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(missing);
Excel.ChartObject chartObject1 = ChartObjects1.Add(100, 20, 400, 250);
chartObject1.Chart.ChartWizard(this.Range["A1", "B3"],
Excel.XlChartType.xl3DColumn, missing, missing, missing,
missing, missing, "New Chart", missing, missing, missing);
chartObject1.Name = "NewChartObject";
Excel.ChartObject chartObject2 =
(Excel.ChartObject)this.ChartObjects("NewChartObject");
chartObject2.Chart.PrintPreview(false);
}
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.