ChartArea Klasse

Definition

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Stellt einen Diagrammbereich im Diagrammbild dar.

public ref class ChartArea : System::Web::UI::DataVisualization::Charting::ChartNamedElement

public class ChartArea : System.Web.UI.DataVisualization.Charting.ChartNamedElement

type ChartArea = class
    inherit ChartNamedElement

Public Class ChartArea
Inherits ChartNamedElement

Vererbung

Object

ChartElement

ChartNamedElement

ChartArea

Hinweise

In einem beliebigen Diagramm ist die innere Plotposition der rechteckige Bereich innerhalb der x- und y-Achse, in der die Datenpunkte gezeichnet werden. Die Plotposition ist der rechteckige Bereich, der die innere Plotposition, die Tickmarkierungen und die Achsenbeschriftungen umfasst. Der Diagrammbereich ist der rechteckige Bereich, der die Plotposition, die Häkchen, 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 gezeichnet werden können, ist unbegrenzt.

Ein ChartArea Objekt:

• Verwendet einen unterschiedlichen inneren Plotbereich.

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

• Verfügt über primäre und sekundäre x- und y-Achsen, mit Ausnahme von Kreis- und Ringdiagrammtypen.

Wenn Sie Shape-Diagrammtypen verwenden, die Kreis-, Ring-, Trichter-, Pyramiden-, Polar- und Radardiagramme umfassen, definiert die innere Plotposition die Größe des Diagrammtyp-Shapes. 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 jeder Diagrammbereich über zwei Sätze von X- und Y-Achsen, primär und sekundär. Um auf Eigenschaften zuzugreifen, die sich auf diese Achsen beziehen, verwenden Sie die AxisXEigenschaften , AxisX2und AxisYAxisY2 . Wenn Sie eine Eigenschaft festlegen müssen, die sich auf alle Achsen des Diagramms auswirkt, verwenden Sie die Axes -Eigenschaft.

Eine oder mehrere Reihen sind einem Diagrammbereich zugeordnet. Die Reihe verfügt über eine ChartArea Eigenschaft, die den Diagrammbereich bestimmt, zu dem jede Reihe gehört. Standardmäßig ist die Reihe 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 ein weiterer Diagrammbereich hinzugefügt wird, können Sie dem neuen Diagrammbereich jede Reihe zuordnen. In allen Shape-Diagrammtypen sowie Balkendiagrammtypen und gestapelten Balkendiagrammtypen muss jede Reihe in einem separaten Diagrammbereich dargestellt werden. In allen anderen Diagrammtypen können mehrere Reihen im selben Diagrammbereich kombiniert werden.

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

Das Minimum und maximum des Diagrammbereichs werden 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.
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 einen Wert ab, der angibt, ob ein Diagrammbereich sichtbar ist, oder legt diesen fest.

Methoden

Dispose()	Gibt die von der ChartElement verwendeten Ressourcen frei. (Geerbt von ChartElement)
Dispose(Boolean)	Gibt die von der ChartArea-Klasse verwendeten nicht verwalteten Ressourcen frei und gibt (optional) auch die verwalteten 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.