WorksheetBase.ChartObjects-Methode

Artikel
05/07/2013

Ruft ein Objekt ab, das entweder ein einzelnes eingebettetes Diagramm (Microsoft.Office.Interop.Excel.ChartObject) oder eine Auflistung aller eingebetteten Diagramme (Microsoft.Office.Interop.Excel.ChartObjects) im Arbeitsblatt darstellt.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

'Declaration
Public Function ChartObjects ( _
    index As Object _
) As Object

public Object ChartObjects(
    Object index
)

Parameter

index
Typ: System.Object
Name oder Nummer des Diagramms.Dieses Argument kann ein Array sein, mit dem mehr als ein Diagramm angegeben werden kann.

Rückgabewert

Typ: System.Object
Ein Objekt, das entweder ein einzelnes eingebettetes Diagramm (Microsoft.Office.Interop.Excel.ChartObject) oder eine Auflistung aller eingebetteten Diagramme (Microsoft.Office.Interop.Excel.ChartObjects) im Arbeitsblatt darstellt.

Hinweise

Diese Methode entspricht nicht der Charts-Eigenschaft.Diese Methode gibt eingebettete Diagramme zurück; die Charts-Eigenschaft gibt Diagrammblätter zurück.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ChartObjects-Methode verwendet wird, um die Auflistung der eingebetteten Diagramme und ein einzelnes eingebettetes Diagramm abzurufen.Zunächst wird die ChartObjects-Methode verwendet, um die Microsoft.Office.Interop.Excel.ChartObjects-Auflistung des aktuellen Arbeitsblatts abzurufen und ein neues Microsoft.Office.Interop.Excel.ChartObject zu erstellen.Nachdem das neue Microsoft.Office.Interop.Excel.ChartObject formatiert und ein Name für das Microsoft.Office.Interop.Excel.ChartObject vergeben wurde, wird anschließend die ChartObjects-Methode verwendet, um das neue Microsoft.Office.Interop.Excel.ChartObject abzurufen (das von seinem Namen indiziert wird). Weiterhin wird eine Seitenansicht des Diagramms angezeigt.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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);
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

WorksheetBase Klasse

Microsoft.Office.Tools.Excel-Namespace

Freigeben über