Chart-Objekt (Excel)

Stellt ein Diagramm in einer Arbeitsmappe dar.

Bemerkungen

Das Diagramm kann entweder ein eingebettetes Diagramm (in einem ChartObject-Objekt enthalten) oder ein separates Diagrammblatt sein.

Die Charts-Sammlung enthält ein Chart-Objekt für jedes Diagrammblatt in einer Arbeitsmappe. Verwenden Sie Charts (index), um ein einzelnes Chart-Objekt zurückzugeben, wobei index die Indexnummer oder den Namen des Diagrammblatts darstellt.

Die Indexnummer des Diagramms stellt die Position des Diagrammblatts auf der Registerkartenleiste der Arbeitsmappe dar. Charts(1) ist das erste Diagramm in der Arbeitsmappe (ganz links); Charts(Charts.Count) das letzte (ganz rechts).

Alle Diagrammblätter sind in der Nummerierung enthalten, auch dann, wenn sie ausgeblendet sind. Der Name des Diagrammblatts wird auf der Registerkarte "Arbeitsmappe" des Diagramms angezeigt. Verwenden Sie die Name Eigenschaft des ChartObject-Objekts, um den Diagrammnamen festzulegen oder zurückzugeben.

Im folgenden Beispiel wird die Farbe von Datenreihe 1 auf Diagrammblatt 1 geändert.

Charts(1).SeriesCollection(1).Format.Fill.ForeColor.RGB = rgbRed

Im folgenden Beispiel wird das Diagramm namens "Sales" ans Ende der aktiven Arbeitsmappe verschoben.

Charts("Sales").Move after:=Sheets(Sheets.Count)

Das Objekt Chart ist ebenfalls ein Member der Sammlung Sheets, die alle Blätter in der Arbeitsmappe enthält (sowohl Diagrammblätter als auch Arbeitsblätter). Verwenden Sie Sheets (index), wobei index die Blattindexnummer oder der Blattindexname ist, um ein einzelnes Blatt zurückzugeben.

Wenn ein Diagramm das aktive Objekt ist, können Sie mithilfe der Eigenschaft ActiveChart darauf verweisen. Ein Diagrammblatt ist aktiv, wenn der Benutzer es ausgewählt hat oder es mit der Methode Activate des Objekts Chart oder mit der Methode Activate des Objekts ChartObject aktiviert wurde.

Das folgende Beispiel aktiviert Diagrammblatt 1 und legt dann den Diagrammtyp und den Titel fest.

Charts(1).Activate 
With ActiveChart 
 .Type = xlLine 
 .HasTitle = True 
 .ChartTitle.Text = "January Sales" 
End With

Ein eingebettetes Diagramm ist aktiv, wenn der Benutzer es ausgewählt hat, oder das Objekt ChartObject, in welchem es enthalten ist, mit der Methode Activate aktiviert wurde.

Im folgenden Beispiel wird das eingebettete Diagramm 1 auf Arbeitsblatt 1 aktiviert, und anschließend werden der Diagrammtyp und -titel festgelegt. Beachten Sie, dass, nachdem das eingebettete Diagramm aktiviert wurde, der Code in diesem Diagramm mit Code aus dem vorherigen Beispiel übereinstimmt. Die Verwendung der Eigenschaft ActiveChart ermöglicht Ihnen das Schreiben von Visual Basic-Code, der entweder auf ein eingebettetes Diagramm oder ein Diagrammblatt (was auch immer gerade aktiv ist) verweisen kann.

Worksheets(1).ChartObjects(1).Activate 
ActiveChart.ChartType = xlLine 
ActiveChart.HasTitle = True 
ActiveChart.ChartTitle.Text = "January Sales"

Wenn ein Diagrammblatt das aktive Blatt ist, können Sie mithilfe der Eigenschaft ActiveSheet darauf verweisen. Im folgenden Beispiel wird die Methode Activate zum Aktivieren des Diagrammblatts mit dem Namen Diagrammblatt 1 verwendet, anschließend wird die Innenfarbe für Datenreihe 1 im Diagramm auf Blau festgelegt.

Charts("chart1").Activate 
ActiveSheet.SeriesCollection(1).Format.Fill.ForeColor.RGB = rgbBlue

Ereignisse

Methoden

Eigenschaften

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.