Chart.HitTest Método

Definição

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Determina o elemento do gráfico, se houver, que está localizado em um ponto definido por determinadas coordenadas X e Y.

Sobrecargas

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

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 y parâmetros x 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 do gráfico, se houver, que está localizado em um ponto definido por determinadas coordenadas X e Y.

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 no qual o usuário clicou.

Retornos

HitTestResult

Um objeto HitTestResult, que fornece informações sobre o elemento 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.

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, Boolean)

Determina o elemento do gráfico, se houver, que está localizado em um ponto definido por coordenadas X e Y fornecidas. 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 objeto HitTestResult, que fornece informações sobre o elemento 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.

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, ChartElementType)

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

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 objeto HitTestResult, que fornece informações sobre o elemento 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.

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, Boolean, ChartElementType[])

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

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 do ponto de dados especificado.

ignoreTransparent

Boolean

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

requestedElement

ChartElementType[]

Uma matriz de objetos ChartElementType que especificam os tipos para os quais testar, para filtrar o resultado. Se omitido, a procura por tipos de elemento será ignorada e todos os tipos de elemento serão válidos.

Retornos

HitTestResult[]

Uma matriz de objetos HitTestResult que fornece informações sobre o elemento gráfico, se houver, encontrado no local especificado. A matriz contém pelo menos um elemento, que pode ser Nothing. Os objetos no resultado são classificados de cima para baixo 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.