ChartArea.GetSeriesDepth(Series) Methode

Definition

Gibt die Tiefe einer Series in einem Diagrammbereich zurück.

public:
 float GetSeriesDepth(System::Windows::Forms::DataVisualization::Charting::Series ^ series);
public float GetSeriesDepth (System.Windows.Forms.DataVisualization.Charting.Series series);
member this.GetSeriesDepth : System.Windows.Forms.DataVisualization.Charting.Series -> single
Public Function GetSeriesDepth (series As Series) As Single

Parameter

series
Series

Die Series, deren Tiefe abgerufen wird.

Gibt zurück

Ein float-Wert, der die Tiefe der angegebenen Series darstellt, die als Prozentsatz der Tiefe des Diagrammbereichs angegeben wird.

Hinweise

Rufen Sie diese Methode auf, um die Tiefe einer angegebenen Reihe zu erhalten. Der zurückgegebene Wert wird als Prozentsatz der Tiefe des Diagrammbereichs gemessen, d. h. die gleiche Maßeinheit, die in der Z -Eigenschaft verwendet wird.

Alle Datenreihen weisen unabhängig von ihrem Diagrammtyp eine Tiefe auf. Beispielsweise weisen gerade Punkt- und Blasenreihen eine Tiefe auf, obwohl die gesamte Tiefe nicht zum Zeichnen der Punkte oder Blasen verwendet wird.

Die Tiefe einer Reihe kann verwendet werden, um einen Z-Wert für einen Punkt zu bestimmen, der in einer benutzerdefinierten Zeichnungsroutine verwendet wird.

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.

Gilt für: