Método Chart.ChartObjects

Artigo
05/21/2013

Obtém um objeto que representa um único elemento gráfico inserido (um objeto de ChartObject ) ou uma coleção de todos os elementos gráficos inseridos (um objeto de ChartObjects ) na folha.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function ChartObjects ( _
    Index As Object _
) As Object

Object ChartObjects(
    Object Index
)

Parâmetros

Index
Tipo: System.Object
O nome ou o número de 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 um único elemento gráfico inserido (um objeto de ChartObject ) ou uma coleção de todos os elementos gráficos inseridos (uma coleção de ChartObjects ) na folha.

Comentários

Este método não é equivalente à propriedade de Charts .Esse método retorna elementos gráficos inseridos; retorna a propriedade de Charts traçam um gráfico folhas.Use a propriedade de Chart para retornar o objeto de Chart para um gráfico inserido.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir cria Chart e usa o método de ChartObjects para exibir mesmo se o elemento gráfico esteve criado pelo Microsoft Office Excel.

Private Sub UseChartObjects()
    Me.Range("A1", "A5").Value2 = 22
    Me.Range("B1", "B5").Value2 = 55

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart = _
        Me.Controls.AddChart(Me.Range("D2", "H12"), "Chart1")

    Chart1.SetSourceData(Me.Range("A1", "B5"), Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType.xlColumnClustered

    Dim chartObjects1 As Excel.ChartObjects = _
        CType(Chart1.ChartObjects(), Excel.ChartObjects)

    If chartObjects1.Creator = Excel.XlCreator.xlCreatorCode Then
        MsgBox("The ChartObjects was created by Microsoft Office Excel.")
    End If

End Sub

private void UseChartObjects()
{
    this.Range["A1", "A5"].Value2 = 22;
    this.Range["B1", "B5"].Value2 = 55;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["D2", "H12"], 
        "chart1");

    chart1.SetSourceData(this.Range["A1", "B5"], 
        Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xlColumnClustered;

    Excel.ChartObjects chartObjects1 =
        (Excel.ChartObjects)chart1.ChartObjects();

    if (chartObjects1.Creator == Excel.XlCreator.xlCreatorCode)
    {
        MessageBox.Show("The ChartObjects was created by " +
            "Microsoft Office Excel.");
    }
}

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.

Consulte também

Referência

Chart Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via