ChartArea Klasse

Definition

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Stellt einen Diagrammbereich im Diagrammbild dar.

public ref class ChartArea : System::Windows::Forms::DataVisualization::Charting::ChartNamedElement

public class ChartArea : System.Windows.Forms.DataVisualization.Charting.ChartNamedElement

type ChartArea = class
    inherit ChartNamedElement

Public Class ChartArea
Inherits ChartNamedElement

Vererbung

Object

ChartElement

ChartNamedElement

ChartArea

Hinweise

Innerhalb eines bestimmten Diagramms ist die innere Zeichnungsposition der rechteckige Bereich innerhalb der x- und y-Achse, in der die Datenpunkte gezeichnet werden. Die Plotposition ist der rechteckige Bereich, der die innere Zeichnungsposition, die Teilstriche und die Achsenbeschriftungen umfasst. Die Diagrammfläche ist der rechteckige Bereich, der die Zeichnungsposition, die Teilstriche, die Achsenbeschriftungen und die Achsentitel im Diagramm umfasst.

Ein Diagrammbereich wird durch eine ChartArea -Klasse dargestellt. ChartArea Objekte werden in der ChartAreaCollection -Klasse gespeichert.

Die Anzahl der Diagrammreihen, die in einem Diagrammbereich dargestellt werden können, ist unbegrenzt.

Ein ChartArea -Objekt:

• Verwendet einen eindeutigen inneren Plotbereich.

• Wird verwendet, um eine oder mehrere Diagrammreihen zu zeichnen.

• Hat primäre und sekundäre x- und y-Achsen, mit Ausnahme von Kreis- und Ringdiagrammtypen.

Wenn Sie Formdiagrammtypen verwenden, die Kreis-, Ring-, Trichter-, Pyramiden-, Polar- und Radardiagramme umfassen, definiert die innere Zeichnungsposition die Größe der Diagrammtypform. Wenn Sie beispielsweise den Wert der InnerPlotPosition Eigenschaft in einem Kreisdiagramm erhöhen, erhöhen Sie den Radius der Kreisform.

Für alle anderen Diagrammtypen verfügt jede Diagrammfläche über zwei Sätze von X- und Y-Achsen, primär und sekundär. Verwenden Sie die Eigenschaften , AxisX2AxisY undAxisY2, um auf Eigenschaften zuzugreifen, die AxisXsich auf diese Achsen beziehen. Wenn Sie eine Eigenschaft festlegen müssen, die sich auf alle Achsen im Diagramm auswirkt, verwenden Sie die Axes -Eigenschaft.

Eine oder mehrere Reihen sind einer Diagrammfläche zugeordnet. Die Datenreihe verfügt über eine ChartArea -Eigenschaft, die die Diagrammfläche bestimmt, zu der jede Datenreihe gehört. Standardmäßig ist die Datenreihe mit dem Standarddiagrammbereich verbunden. Um die Anzeige einer Reihe zu deaktivieren, legen Sie die ChartArea -Eigenschaft dieser Reihe auf eine Zeichenfolge der Länge Null fest.

Wenn dem Diagramm eine weitere Diagrammfläche hinzugefügt wird, können Sie der neuen Diagrammfläche eine beliebige Datenreihe zuordnen. In allen Formendiagrammtypen sowie Balkendiagrammtypen und gestapelten Balkendiagrammtypen muss jede Datenreihe in einem separaten Diagrammbereich dargestellt werden. In allen anderen Diagrammtypen können mehrere Reihen im gleichen Diagrammbereich kombiniert werden.

Ein 3D-Diagramm wird flächenweise auf Diagrammbasis angezeigt. Sie können die Area3DStyle -Eigenschaft verwenden, um Ihr Diagramm in 3D zu aktivieren und anzupassen.

Die minimale und maximale Diagrammfläche wird nicht automatisch neu berechnet, wenn Sie neue Daten hinzufügen, sodass das Diagramm die Achsengrößen nicht automatisch ändert. Sie können verlangen, dass der Diagrammbereich diese Werte mit der RecalculateAxesScale -Methode neu berechnet.

Um mehrere Diagrammbereiche vertikal auszurichten, legen Sie die AlignmentOrientation -Eigenschaft fest. Um mehrere Diagrammbereiche horizontal auszurichten, müssen Sie zuerst die Diagrammbereiche mithilfe der Position -Eigenschaft positionieren und dann die AlignmentOrientation -Eigenschaft auf Horizontal festlegen.

Um die Anzeige einer Reihe zu unterdrücken, legen Sie die Series -Eigenschaft dieser Reihe auf eine Zeichenfolge der Länge Null fest.

Konstruktoren

ChartArea()	Initialisiert eine neue Instanz der ChartArea-Klasse.
ChartArea(String)	Initialisiert eine neue Instanz der ChartArea-Klasse mit dem angegebenen Diagrammbereichsnamen.

Eigenschaften

AlignmentOrientation	Ruft die Ausrichtung eines Diagrammbereichs ab oder legt diese fest.
AlignmentStyle	Ruft die Ausrichtungsart der ChartArea ab oder legt diese fest.
AlignWithChartArea	Ruft den Namen des ChartArea-Objekts ab, an dem dieser Diagrammbereich ausgerichtet werden soll, oder legt diesen fest.
Area3DStyle	Ruft ein ChartArea3DStyle-Objekt ab, das zum Implementieren von 3D für alle Reihen in einem Diagrammbereich verwendet wird, oder legt dieses fest.
Axes	Ruft ein Array ab, das alle Achsen für einen Diagrammbereich darstellt, oder legt dieses fest.
AxisX	Ruft ein Axis-Objekt ab, das die primäre x-Achse darstellt, oder legt dieses fest.
AxisX2	Ruft ein Axis-Objekt ab, das die sekundäre x-Achse darstellt, oder legt dieses fest.
AxisY	Ruft ein Axis-Objekt ab, das die primäre y-Achse darstellt, oder legt dieses fest.
AxisY2	Ruft ein Axis-Objekt ab, das die sekundäre y-Achse darstellt, oder legt dieses fest.
BackColor	Ruft die Hintergrundfarbe eines ChartArea-Objekts ab oder legt diese fest.
BackGradientStyle	Ruft die Ausrichtung für den Hintergrundfarbverlauf eines Diagrammbereichs ab oder legt diese fest und bestimmt außerdem, ob ein Farbverlauf verwendet wird.
BackHatchStyle	Ruft den Schraffurstil eines ChartArea-Objekts ab oder legt diesen fest.
BackImage	Ruft das Hintergrundbild eines ChartArea-Objekts ab oder legt dieses fest.
BackImageAlignment	Ruft die Ausrichtung eines ChartArea-Hintergrundbilds ab oder legt diese fest.
BackImageTransparentColor	Ruft die Farbe eines als transparent gezeichneten Hintergrundbilds für ein ChartArea-Objekt ab oder legt diese fest.
BackImageWrapMode	Ruft den Zeichnungsmodus für das Hintergrundbild eines ChartArea-Objekts ab oder legt diesen fest.
BackSecondaryColor	Ruft die sekundäre Farbe für den Hintergrund eines ChartArea-Objekts ab oder legt diese fest.
BorderColor	Ruft die Rahmenfarbe eines ChartArea-Objekts ab oder legt diese fest.
BorderDashStyle	Ruft die Rahmenart eines ChartArea-Objekts ab oder legt diese fest.
BorderWidth	Ruft die Rahmenbreite eines ChartArea-Objekts ab oder legt diese fest.
CursorX	Ruft ein Cursor-Objekt ab, das für Cursor und ausgewählte Bereiche auf der X-Achse verwendet wird, oder legt es fest.
CursorY	Ruft ein Cursor-Objekt ab, das für Cursor und ausgewählte Bereiche auf der Y-Achse verwendet wird, oder legt es fest.
InnerPlotPosition	Ruft ein ElementPosition-Objekt ab, das die innere Zeichnungsposition eines Diagrammbereichsobjekts definiert, oder legt dieses fest.
IsSameFontSizeForAllAxes	Ruft ein Flag ab, das bestimmt, ob die Bezeichnungen der relevanten Diagrammbereichsachsen die gleiche Größe aufweisen, oder legt dieses fest.
Name	Ruft den eindeutigen Namen eines ChartArea-Objekts ab oder legt diesen fest.
Position	Ruft ein ElementPosition-Objekt ab, das die Position eines ChartArea-Objekts in der Chart darstellt, oder legt dieses fest.
ShadowColor	Ruft die Schattenfarbe eines ChartArea-Objekts ab oder legt diese fest.
ShadowOffset	Ruft den Schattenoffset in Pixel eines ChartArea-Objekts ab oder legt diesen fest.
Tag	Ruft ein Objekt ab, das dem Diagrammelement zugeordnet ist, oder legt dieses fest. (Geerbt von ChartElement)
Visible	Ruft ein Flag ab, das bestimmt, ob ein Diagrammbereich sichtbar ist, oder legt dieses fest.

Methoden

Dispose()	Gibt die von der ChartElement verwendeten Ressourcen frei. (Geerbt von ChartElement)
Dispose(Boolean)	Gibt nicht verwaltete und optional verwaltete Ressourcen frei.
Equals(Object)	Bestimmt, ob das angegebene Object und das aktuelle ChartElement gleich sind. (Geerbt von ChartElement)
GetHashCode()	Gibt eine Hashfunktion für einen bestimmten Typ zurück. (Geerbt von ChartElement)
GetSeriesDepth(Series)	Gibt die Tiefe einer Series in einem Diagrammbereich zurück.
GetSeriesZPosition(Series)	Gibt die z-Position einer Reihe zurück. Dies ist für benutzerdefinierte Zeichnungen hilfreich.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
RecalculateAxesScale()	Berechnet die Eigenschaften des Diagrammbereichs neu, nachdem im Customize-Ereignis Änderungen am Diagramm vorgenommen wurden.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Object-Objekt darstellt. (Geerbt von ChartElement)
TransformPoints(Point3D[])	Wendet 3D-Transformationen auf ein Array von 3D-Punkten an. Dies ist erforderlich, bevor GDI+-Zeichnungsmethoden aufgerufen werden können.