Chart Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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. |