Freigeben über


ChartArea Klasse

Definition

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

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.

Gilt für: