ChartArea.GetSeriesDepth(Series) Método

Definição

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Retorna a profundidade de um Series em uma área do gráfico.

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

Parâmetros

series

Series

O Series para o qual a profundidade é recuperada.

Retornos

Single

Um valor float que representa a profundidade da Series especificada, que é medida como um percentual de profundidade de uma área do gráfico.

Comentários

Chame esse método para obter a profundidade de uma série especificada. O valor retornado é medido como um percentual da profundidade da área do gráfico, que é a mesma unidade de medida usada na Z propriedade .

Todas as séries têm uma profundidade, independentemente do tipo de gráfico. Por exemplo, até mesmo as séries de ponto e bolha têm uma profundidade, mesmo que toda a profundidade não seja usada para desenhar os pontos ou bolhas.

A profundidade de uma série pode ser usada para determinar um valor Z para um ponto que é usado em uma rotina de desenho personalizada.

Observação

Todos os pontos usados no desenho 3D personalizado devem ser transformados de coordenadas 3D relativas para coordenadas 2D relativas usando o TransformPoints método .

Para obter valores relativos X e Y de um eixo, use o ValueToPosition método para os eixos X e Y.