Chart.HitTest Método

Definição

Namespace:: System.Windows.Forms.DataVisualization.Charting

Assembly:: System.Windows.Forms.DataVisualization.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Determina o elemento de gráfico, se houver, que está localizado em um ponto definido pelas coordenadas X e Y fornecidas.

Sobrecargas

Nome	Description
HitTest(Int32, Int32)	Determina o elemento de gráfico, se houver, que está localizado em um ponto definido pelas coordenadas X e Y fornecidas.
HitTest(Int32, Int32, Boolean)	Determina o elemento de gráfico, se houver, que está localizado em um ponto definido por determinadas coordenadas X e Y. Os elementos transparentes podem, opcionalmente, ser ignorados.
HitTest(Int32, Int32, ChartElementType)	Determina se um elemento de gráfico de um determinado tipo está localizado em um ponto definido por determinadas coordenadas X e Y.
HitTest(Int32, Int32, Boolean, ChartElementType[])	Determina se um elemento de gráfico que é um dos tipos especificados está localizado em um ponto definido pelas coordenadas X e Y fornecidas.

Comentários

Chame esse método para determinar o elemento de gráfico, se houver, que está localizado em um ponto especificado.

Esse método geralmente é usado em algum evento relacionado ao mouse , por exemplo, OnMouseDown para determinar qual elemento de gráfico o usuário final clicou. As coordenadas do mouse X e Y obtidas dos parâmetros de evento são usadas para os valores e x parâmetros y dessa chamada de método.

As propriedades do HitTestResult objeto retornado podem ser usadas para determinar qual elemento de gráfico foi clicado; o HitTestResult objeto também fornece uma instância do objeto real selecionado, se houver.

HitTest(Int32, Int32)

Determina o elemento de gráfico, se houver, que está localizado em um ponto definido pelas coordenadas X e Y fornecidas.

public:
 System::Windows::Forms::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y);

public System.Windows.Forms.DataVisualization.Charting.HitTestResult HitTest(int x, int y);

member this.HitTest : int * int -> System.Windows.Forms.DataVisualization.Charting.HitTestResult

Public Function HitTest (x As Integer, y As Integer) As HitTestResult

Parâmetros

x: Int32

O valor da coordenada X do ponto em que o usuário clicou.

y: Int32

O valor da coordenada Y do ponto em que o usuário clicou.

Retornos

HitTestResult

Um HitTestResult objeto, que fornece informações sobre o elemento de gráfico, se houver, que está no local especificado.

Comentários

Chame esse método para determinar o elemento de gráfico, se houver, que está localizado em um ponto especificado.

Aplica-se a

HitTest(Int32, Int32, Boolean)

Determina o elemento de gráfico, se houver, que está localizado em um ponto definido por determinadas coordenadas X e Y. Os elementos transparentes podem, opcionalmente, ser ignorados.

public:
 System::Windows::Forms::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, bool ignoreTransparent);

public System.Windows.Forms.DataVisualization.Charting.HitTestResult HitTest(int x, int y, bool ignoreTransparent);

member this.HitTest : int * int * bool -> System.Windows.Forms.DataVisualization.Charting.HitTestResult

Public Function HitTest (x As Integer, y As Integer, ignoreTransparent As Boolean) As HitTestResult

Parâmetros

x: Int32

O valor da coordenada X do ponto em que o usuário clicou.

y: Int32

O valor da coordenada Y do ponto em que o usuário clicou.

ignoreTransparent: Boolean

true para ignorar elementos transparentes; caso contrário, false.

Retornos

HitTestResult

Um HitTestResult objeto, que fornece informações sobre o elemento de gráfico, se houver, que está no local especificado.

Comentários

Chame esse método para determinar o elemento de gráfico, se houver, que está localizado em um ponto especificado.

Para ignorar elementos transparentes, defina o ignoreTransparent parâmetro como true.

Aplica-se a

HitTest(Int32, Int32, ChartElementType)

Determina se um elemento de gráfico de um determinado tipo está localizado em um ponto definido por determinadas coordenadas X e Y.

public:
 System::Windows::Forms::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, System::Windows::Forms::DataVisualization::Charting::ChartElementType requestedElement);

public System.Windows.Forms.DataVisualization.Charting.HitTestResult HitTest(int x, int y, System.Windows.Forms.DataVisualization.Charting.ChartElementType requestedElement);

member this.HitTest : int * int * System.Windows.Forms.DataVisualization.Charting.ChartElementType -> System.Windows.Forms.DataVisualization.Charting.HitTestResult

Public Function HitTest (x As Integer, y As Integer, requestedElement As ChartElementType) As HitTestResult

Parâmetros

x: Int32

O valor da coordenada X do ponto em que o usuário clicou.

y: Int32

O valor da coordenada Y do ponto em que o usuário clicou.

requestedElement: ChartElementType

Um sinalizador que determina o tipo de elemento do gráfico a ser testado.

Retornos

HitTestResult

Um HitTestResult objeto, que fornece informações sobre o elemento de gráfico, se houver, que está no local especificado.

Comentários

Chame esse método para determinar se um elemento de gráfico do tipo determinado está localizado em um ponto especificado.

Aplica-se a

HitTest(Int32, Int32, Boolean, ChartElementType[])

Determina se um elemento de gráfico que é um dos tipos especificados está localizado em um ponto definido pelas coordenadas X e Y fornecidas.

public:
 cli::array <System::Windows::Forms::DataVisualization::Charting::HitTestResult ^> ^ HitTest(int x, int y, bool ignoreTransparent, ... cli::array <System::Windows::Forms::DataVisualization::Charting::ChartElementType> ^ requestedElement);

public System.Windows.Forms.DataVisualization.Charting.HitTestResult[] HitTest(int x, int y, bool ignoreTransparent, params System.Windows.Forms.DataVisualization.Charting.ChartElementType[] requestedElement);

member this.HitTest : int * int * bool * System.Windows.Forms.DataVisualization.Charting.ChartElementType[] -> System.Windows.Forms.DataVisualization.Charting.HitTestResult[]

Public Function HitTest (x As Integer, y As Integer, ignoreTransparent As Boolean, ParamArray requestedElement As ChartElementType()) As HitTestResult()

Parâmetros

x: Int32

A coordenada X do ponto de dados especificado.

y: Int32

A coordenada Y para o ponto de dados especificado.

ignoreTransparent: Boolean

true para ignorar elementos transparentes; caso contrário, false.

requestedElement: ChartElementType[]

Uma matriz de ChartElementType objetos que especifica os tipos para os quais testar, a fim de filtrar o resultado. Se omitido, a verificação de tipos de elementos será ignorada e todos os tipos de elemento serão válidos.

Retornos

HitTestResult[]

Uma matriz de HitTestResult objetos que fornece informações sobre o elemento de gráfico, se houver, encontrada no local especificado. A matriz contém pelo menos um elemento, que pode ser Nothing. Os objetos no resultado são classificados da parte superior para a parte inferior de diferentes camadas de controle.

Comentários

Chame esse método para determinar o elemento de medidor, se houver, que está localizado em um ponto especificado. Esse método geralmente é usado em algum evento relacionado ao mouse, por exemplo, OnMouseDownpara determinar qual elemento de medidor o usuário final clicou. As coordenadas do mouse X e Y obtidas dos parâmetros de evento são usadas para os valores de parâmetro X e Y dessa chamada de método.

As propriedades do objeto retornado HitTestResult podem ser usadas para determinar qual elemento de gráfico foi clicado; o HitTestResult objeto também fornece uma instância do objeto real selecionado, se houver.

Aplica-se a

Comentários

Esta página foi útil?