Freigeben über


Chart Schnittstelle

Definition

Stellt ein Diagramm in einer Dokumentation dar.

public interface class Chart
[System.Runtime.InteropServices.Guid("6FFA84BB-A350-4442-BB53-A43653459A84")]
public interface Chart
type Chart = interface
Public Interface Chart
Attribute

Beispiele

Die InlineShapes Auflistung enthält ein -Objekt für jede Inlineform, einschließlich Diagrammen, in einem Dokument. Verwenden Sie InlineShapes(Index), wobei Index die Indexnummer einer Inlineform ist, um ein einzelnes InlineShape-Objekt zurückzugeben. Verwenden Sie die HasChart -Eigenschaft, um zu bestimmen, ob das InlineShape-Objekt ein Diagramm darstellt. Wenn die HasChart-Eigenschaft auf True festgelegt ist, verwenden Sie die Chart -Eigenschaft, um ein Chart-Objekt zurückzugeben.

Sie können auch die Type -Eigenschaft verwenden, um zu bestimmen, ob das InlineShape-Objekt ein Diagramm darstellt. Ist die Type-Eigenschaft auf WdInlineShapeChart gesetzt, stellt die Inlineform ein Diagramm dar.

Hinweise

Die folgenden Eigenschaften und Methoden für das Zurückgeben eines Chart-Objekts werden im Beispielabschnitt beschrieben:

Eigenschaften

Application

Bei Verwendung ohne Objektqualifizierer gibt diese Eigenschaft ein _Application Objekt zurück, das die Microsoft Word-Anwendung darstellt. Mit Objektkennzeichner hingegen gibt diese Eigenschaft ein Application-Objekt zurück, das die Erstellungsanwendung des angegebenen Objekts darstellt. (Sie können diese Eigenschaft mit einem OLE-Automatisierungsobjekt verwenden, um die Anwendung dieses Objekts zurückzugeben.) Schreibgeschützt.

Area3DGroup

Gibt die Flächendiagrammgruppe in einem 3D-Diagramm zurück.

AutoScaling

Skaliert ein 3D-Diagramm so, dass es dem entsprechenden 2D-Diagramm näher ist. Die RightAngleAxes Eigenschaft muss True sein. Lese-/Schreibzugriff.

BackWall

Gibt ein Walls -Objekt zurück, mit dem der Benutzer die Rückwand eines 3D-Diagramms individuell formatieren kann. Schreibgeschützt.

Bar3DGroup

Gibt die Balkendiagrammgruppe in einem 3D-Diagramm zurück.

BarShape

Gibt die Form zurück, die für jede Datenreihe in einem 3D-Balken- oder -Säulendiagramm verwendet wird, oder legt diese Form fest. Lese-/Schreibzugriff.

CategoryLabelLevel

Gibt eine XlCategoryLabelLevel Konstante zurück, die die Quellebene der Diagrammkategoriebeschriftungen angibt, oder legt sie fest. Lese-/Schreibzugriff.

ChartArea

Gibt ein ChartArea -Objekt zurück, das den gesamten Diagrammbereich für das Diagramm darstellt. Schreibgeschützt.

ChartColor

Gibt eine ganze Zahl zurück oder legt sie fest, die das Farbschema für das Diagramm darstellt. Lese-/Schreibzugriff.

ChartData

Gibt Informationen zu den verknüpften oder eingebetteten Daten zurück, die dem Diagramm zugeordnet sind. Schreibgeschützt.

ChartGroups[Object]

Gibt ein Objekt zurück, das entweder eine einzelne Diagrammgruppe oder eine Auflistung aller Diagrammgruppen im Diagramm darstellt.

ChartStyle

Gibt die Diagrammformatvorlage für das Diagramm zurück, oder legt diese fest. Object -Wert mit Lese-/Schreibzugriff.

ChartTitle

Gibt ein ChartTitle -Objekt zurück, das den Titel des angegebenen Diagramms darstellt. Schreibgeschützt.

ChartType

Gibt den Diagrammtyp zurück oder legt ihn fest. Lese-/Schreibzugriff.

Column3DGroup

Gibt die Säulendiagrammgruppe in einem 3D-Diagramm zurück.

Corners

Gibt die Ecken eines 3D-Diagramms zurück.

Creator

Gibt eine 32-Bit-Ganzzahl zurück, die die Anwendung angibt, in der das angegebene Objekt erstellt wurde. Schreibgeschützt.

DataTable

Gibt ein DataTable -Objekt zurück, das die Diagrammdatentabelle darstellt. Schreibgeschützt.

DepthPercent

Gibt die Tiefe eines 3D-Diagramms als Prozentsatz der Diagrammbreite (zwischen 20 und 2000 Prozent) zurück oder legt sie fest. Lese-/Schreibzugriff.

DisplayBlanksAs

Gibt die Art der Darstellung für leere Zellen in einem Diagramm zurück, oder legt diese fest. Dies kann eine der XlDisplayBlanksAs Konstanten sein. Lese-/Schreibzugriff.

Elevation

Gibt die Betrachtungshöhe für 3D-Diagramme in Grad zurück oder legt sie fest. Lese-/Schreibzugriff.

Floor

Gibt ein Floor -Objekt zurück, das den Boden des 3D-Diagramms darstellt. Schreibgeschützt.

GapDepth

Gibt den Zwischenraum zwischen den Datenreihen in einem 3D-Diagramm als Prozentwert der Markierungsbreite (zwischen 0 und 500) zurück oder legt ihn fest. Long Lese-/Schreibzugriff.

HasAxis[Object, Object]

Gibt zurück oder legt fest, welche Achsen im Diagramm vorhanden sind. Lese-/Schreibzugriff.

HasDataTable

Ruft einen Wert ab, der angibt, ob über Chart eine Datentabelle verfügt, oder legt diesen fest. Lese-/Schreibzugriff.

HasHiddenContent

Stellt ein Diagramm in einer Dokumentation dar.

HasLegend

Gibt True zurück, wenn das Diagramm über eine Legende verfügt. Lese-/Schreibzugriff.

HasPivotFields

Bestimmt, ob die PivotChart-Steuerelemente im angegebenen PivotChart-Bericht angezeigt werden.

HasTitle

True, wenn die Achse eine sichtbare Beschriftung oder das Diagramm einen sichtbaren Titel aufweist. Lese-/Schreibzugriff.

HeightPercent

Gibt die Höhe eines 3D-Diagramms als Prozentsatz der Breite des Diagramms zurück (zwischen 5 und 500 Prozent) oder legt diese Höhe fest. Lese-/Schreibzugriff.

Legend

Gibt ein Legend -Objekt zurück, das die Legende für das Diagramm darstellt. Schreibgeschützt.

Line3DGroup

Gibt die Liniendiagrammgruppe in einem 3D-Diagramm zurück.

Parent

Gibt das übergeordnete Element für das angegebene Objekt zurück. Schreibgeschützt.

Perspective

Dient zum Zurückgeben oder Festlegen eines Integer-Werts, der die Perspektive für die 3D-Diagrammansicht darstellt.

Pie3DGroup

Gibt die Kreisdiagrammgruppe in einem 3D-Diagramm zurück.

PivotLayout

Für dieses Objekt nicht unterstützt.

PlotArea

Gibt ein PlotArea -Objekt zurück, das die Zeichnungsfläche eines Diagramms darstellt. Schreibgeschützt.

PlotBy

Gibt zurück, wie Spalten oder Zeilen als Datenreihen im Diagramm verwendet werden, oder legt dies fest. Kann eine der folgenden XlRowCol Konstanten sein: xlColumns oder xlRows. Lese-/Schreibzugriff.

PlotVisibleOnly

Ruft einen Wert ab, der angibt, ob nur sichtbare Zellen gezeichnet werden, oder legt diesen fest. Lese-/Schreibzugriff.

RightAngleAxes

True, wenn die Diagrammachsen im rechten Winkel zueinander stehen, unabhängig von der Drehung oder der Betrachtungshöhe des Diagramms. Nur für 3D-Linien-, Säulen- und Balkendiagramme gültig. Lese-/Schreibzugriff.

Rotation

Gibt die Drehung der 3D-Diagrammansicht zurück oder legt sie fest (die Drehung der Zeichnungsfläche um die Z-Achse in Grad). Der Wert dieser Eigenschaft muss zwischen 0 und 360 liegen, mit Ausnahme von 3D-Balkendiagrammen, bei denen der Wert zwischen 0 und 44 liegen muss. Der Standardwert ist 20. Gilt nur für 3D-Diagramme. Lese-/Schreibzugriff.

SeriesNameLevel

Gibt eine XlSeriesNameLevel Konstante zurück, die die Quellebene der Reihennamen angibt, oder legt sie fest. Lese-/Schreibzugriff.

Shapes

Gibt eine Shapes Auflistung zurück, die alle Formen auf dem Diagrammblatt darstellt. Schreibgeschützt.

ShowAllFieldButtons

Dieses Objekt, dieses Mitglied oder diese Aufzählung ist veraltet und kann nicht in Ihrem Code verwendet werden.

ShowAxisFieldButtons

Dieses Objekt, dieses Mitglied oder diese Aufzählung ist veraltet und kann nicht in Ihrem Code verwendet werden.

ShowDataLabelsOverMaximum

Gibt zurück oder legt fest, ob die Datenbeschriftungen angezeigt werden sollen, wenn der Wert größer als der Maximalwert auf der Größenachse ist. Lese-/Schreibzugriff.

ShowLegendFieldButtons

Dieses Objekt, dieses Mitglied oder diese Aufzählung ist veraltet und kann nicht in Ihrem Code verwendet werden.

ShowReportFilterFieldButtons

Dieses Objekt, dieses Element oder diese Enumeration ist veraltet und ist nicht für die Verwendung in Ihrem Code vorgesehen.

ShowValueFieldButtons

Dieses Objekt, dieses Element oder diese Enumeration ist veraltet und ist nicht für die Verwendung in Ihrem Code vorgesehen.

SideWall

Gibt ein Walls -Objekt zurück, mit dem der Benutzer die Seitenwand eines 3D-Diagramms individuell formatieren kann. Schreibgeschützt.

SubType

Diese API unterstützt die Visual Studio-Tools für Office-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

SurfaceGroup

Gibt die Oberflächendiagrammgruppe eines 3D-Diagramms zurück.

Type

Für die interne Verwendung reserviert.

Walls

Gibt ein Walls -Objekt zurück, das die Wände des 3D-Diagramms darstellt. Schreibgeschützt.

Methoden

ApplyChartTemplate(String)

Weist einem Diagramm einen Standarddiagrammtyp oder einen benutzerdefinierten Diagrammtyp zu.

ApplyCustomType(XlChartType, Object)

Weist einem Diagramm einen Standarddiagrammtyp oder einen benutzerdefinierten Diagrammtyp zu.

ApplyDataLabels(XlDataLabelsType, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Wendet auf alle Reihen in einem Diagramm Datenbeschriftungen an.

ApplyLayout(Int32, Object)

Wendet die im Band angezeigten Layouts an.

AreaGroups(Object)

Gibt in einem 2D-Diagramm ein Objekt zurück, das entweder eine einzelne Flächendiagrammgruppe (ein ChartGroup Objekt) oder eine Auflistung der Flächendiagrammgruppen (eine ChartGroups Auflistung) darstellt.

AutoFormat(Int32, Object)

Diese API unterstützt die Visual Studio-Tools für Office-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Axes(Object, XlAxisGroup)

Ruft ein -Objekt ab, das entweder eine einzelne Achse oder eine Auflistung von Achsen im Diagramm darstellt.

BarGroups(Object)

Gibt in einem 2D-Diagramm ein Objekt zurück, das entweder eine einzelne Balkendiagrammgruppe (ein ChartGroup -Objekt) oder eine Auflistung der Balkendiagrammgruppen (eine ChartGroups Auflistung) darstellt.

ChartWizard(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Ändert die Eigenschaften für ein bestimmtes Diagramm. Ermöglicht die schnelle Formatierung eines Diagramms, ohne jede einzelne Eigenschaft festzulegen. Diese Methode ist nicht interaktiv und ändert nur die angegebenen Eigenschaften.

ClearToMatchColorStyle()

Löscht alle Farben im angegebenen Diagramm, die nicht dem auf das Diagramm angewendeten Farbstil entsprechen.

ClearToMatchStyle()

Deaktiviert die Formatierung der Diagrammelemente und legt die automatische Formatierung fest.

ColumnGroups(Object)

Gibt in einem 2D-Diagramm ein Objekt zurück, das entweder eine einzelne Säulendiagrammgruppe (ein ChartGroup -Objekt) oder eine Auflistung der Säulendiagrammgruppen (eine ChartGroups Auflistung) darstellt.

Copy(Object, Object)

Für dieses Objekt nicht unterstützt.

CopyPicture(XlPictureAppearance, XlCopyPictureFormat, XlPictureAppearance)

Kopiert das ausgewählte Objekt als Bild in die Zwischenablage.

Delete()

Löscht das Objekt.

DeleteHiddenContent()

Stellt ein Diagramm in einer Dokumentation dar.

DoughnutGroups(Object)

Gibt in einem 2D-Diagramm ein Objekt zurück, das entweder eine einzelne Ringdiagrammgruppe (ein ChartGroup -Objekt) oder eine Auflistung der Ringdiagrammgruppen (eine ChartGroups Auflistung) darstellt.

Export(String, Object, Object)

Exportiert das Diagramm in einem Grafikformat. Diese Methode gibt einen booleschen Wert zurück, der angibt, ob der Export erfolgreich war.

FullSeriesCollection(Object)

Gibt die Auflistung aller Datenreihen im angegebenen Diagramm oder der angegebenen Datenreihe zurück.

GetChartElement(Int32, Int32, Int32, Int32, Int32)

Gibt Informationen zum Diagrammelement an den angegebenen X- und Y-Koordinaten zurück. Diese Methode ist insofern ungewöhnlich, als dass Sie nur Werte für die ersten beiden Argumente angeben. Microsoft Word füllt die anderen Argumente, und diese Werte sollten bei der Beendigung der Methode mithilfe Ihres Codes geprüft werden.

LineGroups(Object)

Gibt in einem 2D-Diagramm ein Objekt zurück, das entweder eine einzelne Liniendiagrammgruppe (ein ChartGroup Objekt) oder eine Auflistung der Liniendiagrammgruppen (eine ChartGroups Auflistung) darstellt.

Paste(Object)

Fügt Diagrammdaten aus der Zwischenablage in das angegebene Diagramm ein.

PieGroups(Object)

Gibt in einem 2D-Diagramm ein Objekt zurück, das entweder eine einzelne Kreisdiagrammgruppe (ein ChartGroup Objekt) oder eine Auflistung der Kreisdiagrammgruppen (eine ChartGroups Auflistung) darstellt.

RadarGroups(Object)

Gibt in einem 2D-Diagramm ein Objekt zurück, das entweder eine einzelne Radardiagrammgruppe (ein ChartGroup Objekt) oder eine Auflistung der Radardiagrammgruppen (eine ChartGroups Auflistung) darstellt.

Refresh()

Veranlasst, dass das angegebene Diagramm sofort neu gezeichnet wird.

SaveChartTemplate(String)

Speichert eine benutzerdefinierte Diagrammvorlage in der Liste der verfügbaren Diagrammvorlagen.

Select(Object)

Markiert das Objekt.

SeriesCollection(Object)

Gibt einen Wert vom Typ Object zurück, der alle Datenreihen im Diagramm darstellt.

SetBackgroundPicture(String)

Legt die Hintergrundgrafik für ein Diagramm fest.

SetDefaultChart(Object)

Gibt den Namen der Diagrammvorlage an, die Microsoft Word beim Erstellen neuer Diagramme verwendet.

SetElement(MsoChartElementType)

Legt Diagrammelemente in einem Diagramm. Lese-/Schreibzugriff.

SetSourceData(String, Object)

Legt den Quelldatenbereich für fest Chart.

XYGroups(Object)

Gibt in einem 2D-Diagramm ein Objekt zurück, das entweder eine einzelne Punktdiagrammgruppe (ein ChartGroup Objekt) oder eine Auflistung von Punktdiagrammgruppen (eine ChartGroups Auflistung) darstellt.

Gilt für: