ChartArea.GetSeriesZPosition(Series) Methode

Definition

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Gibt die z-Position einer Reihe zurück. Dies ist für benutzerdefinierte Zeichnungen hilfreich.

public:
 float GetSeriesZPosition(System::Windows::Forms::DataVisualization::Charting::Series ^ series);

public float GetSeriesZPosition (System.Windows.Forms.DataVisualization.Charting.Series series);

member this.GetSeriesZPosition : System.Windows.Forms.DataVisualization.Charting.Series -> single

Public Function GetSeriesZPosition (series As Series) As Single

Parameter

series

Series

Die Series, deren z-Position abgerufen wird.

Gibt zurück

Single

Ein float-Wert, der die z-Position der angegebenen Reihe darstellt, die als Prozentsatz der Tiefe eines Diagrammbereichs angegeben wird.

Hinweise

Rufen Sie diese Methode auf, um die Z-Position einer Reihe abzurufen. Die Z-Position wird von der Rückwand der Diagrammfläche bis zur Mitte einer Datenreihe gemessen und als Prozentsatz der Tiefe des Diagrammbereichs dargestellt. Beispielsweise hat eine Reihe, die auf halbem Weg entlang der Z-Achse gezeichnet wird, eine Z-Position von 50.

Die Z-Position einer Reihe wird normalerweise für eine benutzerdefinierte Zeichnungsroutine verwendet.

Hinweis

Alle Punkte, die in der benutzerdefinierten 3D-Zeichnung verwendet werden, müssen mit der TransformPoints -Methode von relativen 3D-Koordinaten in relative 2D-Koordinaten transformiert werden.

Um relative X- und Y-Werte von einer Achse abzurufen, verwenden Sie die ValueToPosition -Methode sowohl für die X- als auch für die Y-Achse.