ChartArea Klasse

Definition

Stellt einen Diagrammbereich im Diagrammbild dar.Represents a chart area on the chart image.

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

Hinweise

Innerhalb eines gegebenen Diagramms ist die innere Zeichnungs Position der rechteckige Bereich innerhalb der x-und y-Achsen Linien, in denen die Datenpunkte gezeichnet werden.Within any given chart, the inner plot position is the rectangular area, inside the x and y-axis lines, where the data points are drawn. Die Zeichnungs Position ist der rechteckige Bereich, der die innere Zeichnungs Position, die Teil Striche und die Achsen Bezeichnungen umfasst.The plot position is the rectangular area that encompasses the inner plot position, the tick marks, and the axis labels. Der Diagrammbereich ist der rechteckige Bereich, der die Zeichnungs Position, die Teil Striche, die Achsen Bezeichnungen und die Achsentitel im Diagramm umfasst.The chart area is the rectangular area that encompasses the plot position, the tick marks, the axis labels and the axis titles on the chart.

Eine Diagrammbereich wird durch eine ChartArea -Klasse dargestellt. -Objekte werden in der ChartAreaCollection -Klasse gespeichert. ChartAreaA chart area is represented by a ChartArea class; ChartArea objects are stored in the ChartAreaCollection class.

Die Anzahl der Diagramm Reihen, die in einem Diagrammbereich gezeichnet werden können, ist unbegrenzt.The number of chart series that can be plotted in a chart area is unlimited.

Ein ChartArea -Objekt:A ChartArea object:

  • Verwendet einen eindeutigen inneren Zeichnungs Bereich.Uses one distinct inner plotting area.

  • Wird verwendet, um eine oder mehrere Diagramm Reihen zu zeichnen.Is used to plot one or more chart series.

  • Verfügt über primäre und sekundäre x-und y-Achsen, mit Ausnahme von Kreis-und Ring Diagrammtypen.Has primary and secondary x and y-axes, except for pie and doughnut chart types.

Wenn Sie Form Diagrammtypen verwenden, die Kreis-, Ring-, Trichter-, Pyramiden-, Polar-und Netz Diagramme enthalten, definiert die innere Zeichnungs Position die Größe der Diagrammtyp Form.When you use Shape chart types, which includes pie, doughnut, funnel, pyramid, polar, and radar charts, the inner plotting position defines the size of the chart type shape. Wenn Sie z. b. den Wert der InnerPlotPosition -Eigenschaft in einem Kreis Diagramm vergrößern, erhöhen Sie den Radius der Kreis Form.For example, when you increase the value of the InnerPlotPosition property on a pie chart, you will increase the radius of the pie shape.

Für alle anderen Diagrammtypen verfügt jeder Diagrammbereich über zwei Sätze von X-und Y-Achsen, Primär und sekundär.For all other chart types, each chart area has two sets of X- and Y-axes, primary and secondary. Verwenden Sie die AxisXEigenschaften AxisX2 AxisY , undAxisY2 , um auf Eigenschaften im Zusammenhang mit diesen Achsen zuzugreifen.To access properties related to these axes, use the AxisX, AxisX2, AxisY and AxisY2 properties. Wenn Sie eine Eigenschaft festlegen müssen, die alle Achsen des Diagramms betrifft, verwenden Sie Axes die-Eigenschaft.If you need to set a property that affects all axes on the chart, use the Axes property.

Mindestens eine Reihe ist einem Diagrammbereich zugeordnet.One or more series are associated with a chart area. Die-Reihe verfügt ChartArea über eine-Eigenschaft, die die Diagramm Flächen bestimmt, zu denen jede Reihe gehört.The series has a ChartArea property that determines the chart area that each series belongs to. Standardmäßig ist die Reihe mit der Standard Diagrammbereich verbunden.By default, the series is connected to the default chart area. Um die Anzeige einer Reihe zu deaktivieren, legen Sie ChartArea die-Eigenschaft dieser Reihe auf eine Zeichenfolge der Länge 0 (null) fest.To disable the display of a series, set the ChartArea property of that series to a zero-length string.

Wenn dem Diagramm eine andere Diagrammbereich hinzugefügt wird, können Sie eine beliebige Reihe der neuen Diagrammbereich zuordnen.If another chart area is added to the chart, you can associate any series with the new chart area. In allen Form Diagrammtypen sowie in Balken-und gestapelten Balkendiagrammen muss jede Reihe in einem separaten Diagrammbereich gezeichnet werden.In all Shape chart types, as well as bar and stacked bar chart types, each series must be plotted in a separate chart area. In allen anderen Diagrammtypen können mehrere Reihen im gleichen Diagrammbereich kombiniert werden.In all other chart types, multiple series can be combined in the same chart area.

Ein 3D-Diagramm wird in einem Diagramm Flächen Weise dargestellt.A 3D chart is displayed on a chart area-by-chart area basis. Mit der-Eigenschaft Area3DStyle können Sie das Diagramm in 3D aktivieren und anpassen.You can use the Area3DStyle property to enable and customize your chart in 3D.

Der minimal-und Maximalwert des Diagramms wird nicht automatisch neu berechnet, wenn Sie neue Daten hinzufügen, sodass die Achsen Größen nicht automatisch von dem Diagramm geändert werden.The chart area minimum and maximum will not be automatically recalculated if you add new data, so the chart will not automatically change axis sizes. Sie können festlegen, dass der Diagrammbereich diese Werte mithilfe der RecalculateAxesScale -Methode neu berechnen soll.You can require the chart area to recalculate these values by using the RecalculateAxesScale method.

Um mehrere Diagramm Flächen vertikal auszurichten, legen Sie AlignmentOrientation die-Eigenschaft fest.To align multiple chart areas vertically, set the AlignmentOrientation property. Zum horizontalen ausrichten mehrerer Diagramm Bereiche müssen Sie die Diagramm Flächen zuerst mithilfe der Position -Eigenschaft positionieren und dann die AlignmentOrientation -Eigenschaft auf Horizontal festlegen.To align multiple chart areas horizontally, you must first position the chart areas using the Position property, and then set the AlignmentOrientation property to Horizontal.

Wenn Sie die Anzeige einer Reihe unterdrücken möchten, Series legen Sie die-Eigenschaft dieser Reihe auf eine Zeichenfolge der Länge 0 (null) fest.To suppress the display of a series, set the Series property of that series to a zero-length string.

Konstruktoren

ChartArea()

Initialisiert eine neue Instanz der ChartArea-Klasse.Initializes a new instance of the ChartArea class.

ChartArea(String)

Initialisiert eine neue Instanz der ChartArea-Klasse mit dem angegebenen Diagrammbereichsnamen.Initializes a new instance of the ChartArea class with the specified chart area name.

Eigenschaften

AlignmentOrientation

Ruft die Ausrichtung eines Diagrammbereichs ab oder legt diese fest.Gets or sets the alignment orientation of a chart area.

AlignmentStyle

Ruft die Ausrichtungsart der ChartArea ab oder legt diese fest.Gets or sets the alignment style of the ChartArea.

AlignWithChartArea

Ruft den Namen des ChartArea-Objekts ab, an dem dieser Diagrammbereich ausgerichtet werden soll, oder legt diesen fest.Gets or sets the name of the ChartArea object to which this chart area should be aligned.

Area3DStyle

Ruft ein ChartArea3DStyle-Objekt ab, das zum Implementieren von 3D für alle Reihen in einem Diagrammbereich verwendet wird, oder legt dieses fest.Gets or sets a ChartArea3DStyle object, which is used to implement 3D for all series in a chart area.

Axes

Ruft ein Array ab, das alle Achsen für einen Diagrammbereich darstellt, oder legt dieses fest.Gets or sets an array that represents all axes for a chart area.

AxisX

Ruft ein Axis-Objekt ab, das die primäre x-Achse darstellt, oder legt dieses fest.Gets or sets an Axis object that represents the primary X-axis.

AxisX2

Ruft ein Axis-Objekt ab, das die sekundäre x-Achse darstellt, oder legt dieses fest.Gets or sets an Axis object that represents the secondary X-axis.

AxisY

Ruft ein Axis-Objekt ab, das die primäre y-Achse darstellt, oder legt dieses fest.Gets or sets an Axis object that represents the primary Y-axis.

AxisY2

Ruft ein Axis-Objekt ab, das die sekundäre y-Achse darstellt, oder legt dieses fest.Gets or sets an Axis object that represents the secondary Y-axis.

BackColor

Ruft die Hintergrundfarbe eines ChartArea-Objekts ab oder legt diese fest.Gets or sets the background color of a ChartArea object.

BackGradientStyle

Ruft die Ausrichtung für den Hintergrundfarbverlauf eines Diagrammbereichs ab oder legt diese fest und bestimmt außerdem, ob ein Farbverlauf verwendet wird.Gets or sets the orientation for the background gradient of a chart area, and also determines whether or not a gradient is used.

BackHatchStyle

Ruft den Schraffurstil eines ChartArea-Objekts ab oder legt diesen fest.Gets or sets the hatching style of a ChartArea object.

BackImage

Ruft das Hintergrundbild eines ChartArea-Objekts ab oder legt dieses fest.Gets or sets the background image of a ChartArea object.

BackImageAlignment

Ruft die Ausrichtung eines ChartArea-Hintergrundbilds ab oder legt diese fest.Gets or sets the alignment of a ChartArea background image.

BackImageTransparentColor

Ruft die Farbe eines als transparent gezeichneten Hintergrundbilds für ein ChartArea-Objekt ab oder legt diese fest.Gets or sets the color of a ChartArea object background image that will be drawn as transparent.

BackImageWrapMode

Ruft den Zeichnungsmodus für das Hintergrundbild eines ChartArea-Objekts ab oder legt diesen fest.Gets or sets the drawing mode for the background image of a ChartArea object.

BackSecondaryColor

Ruft die sekundäre Farbe für den Hintergrund eines ChartArea-Objekts ab oder legt diese fest.Gets or sets the secondary color for the background of a ChartArea object.

BorderColor

Ruft die Rahmenfarbe eines ChartArea-Objekts ab oder legt diese fest.Gets or sets the border color of a ChartArea object.

BorderDashStyle

Ruft die Rahmenart eines ChartArea-Objekts ab oder legt diese fest.Gets or sets the border style of a ChartArea object.

BorderWidth

Ruft die Rahmenbreite eines ChartArea-Objekts ab oder legt diese fest.Gets or sets the border width of a ChartArea object.

InnerPlotPosition

Ruft ein ElementPosition-Objekt ab, das die innere Zeichnungsposition eines Diagrammbereichsobjekts definiert, oder legt dieses fest.Gets or sets an ElementPosition object, which defines the inner plot position of a chart area object.

IsSameFontSizeForAllAxes

Ruft ein Flag ab, das bestimmt, ob die Bezeichnungen der relevanten Diagrammbereichsachsen die gleiche Größe aufweisen, oder legt dieses fest.Gets or sets a flag that determines if the labels of the relevant chart area axes are of equal size.

Name

Ruft den eindeutigen Namen eines ChartArea-Objekts ab oder legt diesen fest.Gets or sets the unique name of a ChartArea object.

Position

Ruft ein ElementPosition-Objekt ab, das die Position eines ChartArea-Objekts in der Chart darstellt, oder legt dieses fest.Gets or sets an ElementPosition object that defines the position of a ChartArea object within the Chart.

ShadowColor

Ruft die Schattenfarbe eines ChartArea-Objekts ab oder legt diese fest.Gets or sets the shadow color of a ChartArea object.

ShadowOffset

Ruft den Schattenoffset in Pixel eines ChartArea-Objekts ab oder legt diesen fest.Gets or sets the shadow offset, in pixels, of a ChartArea object.

Tag

Ruft ein Objekt ab, das dem Diagrammelement zugeordnet ist, oder legt dieses fest.Gets or sets an object associated with this chart element.

(Geerbt von ChartElement)
Visible

Ruft einen Wert ab, der angibt, ob ein Diagrammbereich sichtbar ist, oder legt diesen fest.Gets or sets a value that indicates if a chart area is visible.

Methoden

Dispose()

Gibt die von der ChartElement verwendeten Ressourcen frei.Releases the resources used by the ChartElement.

(Geerbt von ChartElement)
Dispose(Boolean)

Gibt die von der ChartArea-Klasse verwendeten nicht verwalteten Ressourcen frei und gibt (optional) auch die verwalteten Ressourcen frei.Releases the unmanaged resources used by the ChartArea class and optionally releases the managed resources.

Equals(Object)

Bestimmt, ob das angegebene Object und das aktuelle ChartElement gleich sind.Determines whether the specified Object is equal to the current ChartElement.

(Geerbt von ChartElement)
GetHashCode()

Gibt eine Hashfunktion für einen bestimmten Typ zurück.Returns a hash function for a particular type.

(Geerbt von ChartElement)
GetSeriesDepth(Series)

Gibt die Tiefe einer Series in einem Diagrammbereich zurück.Returns the depth of a Series in a chart area.

GetSeriesZPosition(Series)

Gibt die z-Position einer Reihe zurück. Dies ist für benutzerdefinierte Zeichnungen hilfreich.Returns the Z position of a series, which is useful for custom drawing.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
RecalculateAxesScale()

Berechnet die Eigenschaften des Diagrammbereichs neu, nachdem im Customize-Ereignis Änderungen am Diagramm vorgenommen wurden.Recalculates the properties of the chart area after changes have been made to the chart in the Customize event.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Object-Objekt darstellt.Returns a string that represents the current Object.

(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.Applies 3D transformations to an array of 3D points, which must be done before GDI+ drawing methods can be called.

Gilt für: