Chart.HitTest Método

Definição

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.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, 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.
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)	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.

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, MouseDown - 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 então usadas para os x valores de parâmetro 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.

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::Web::UI::DataVisualization::Charting::HitTestResult ^> ^ HitTest(int x, int y, bool ignoreTransparent, ... cli::array <System::Web::UI::DataVisualization::Charting::ChartElementType> ^ requestedElement);

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

member this.HitTest : int * int * bool * System.Web.UI.DataVisualization.Charting.ChartElementType[] -> System.Web.UI.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

Um sinalizador que indica que os elementos transparentes devem ser ignorados.

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 gauge, se houver, que está localizado em um ponto especificado. Esse método geralmente é usado em algum evento relacionado ao mouse, por exemplo, MouseDown, para 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.

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::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, System::Web::UI::DataVisualization::Charting::ChartElementType requestedElement);

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

member this.HitTest : int * int * System.Web.UI.DataVisualization.Charting.ChartElementType -> System.Web.UI.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, encontrado no local especificado.

Comentários

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

Importante

Para que esse método funcione corretamente, a IsMapEnabled propriedade deve ser definida falsecomo .

Esse método pode ser usado com o evento do lado do Click servidor quando você implementa o drilldown. No entanto, é altamente recomendável que você use mapas de imagens do lado do cliente para drilldown devido à facilidade de uso.

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.

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::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y);

public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest (int x, int y);

member this.HitTest : int * int -> System.Web.UI.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.

Importante

Para que esse método funcione corretamente, a IsMapEnabled propriedade deve ser definida falsecomo .

Esse método pode ser usado com o evento do lado do Click servidor quando você implementa o drilldown. No entanto, é altamente recomendável que você use mapas de imagens do lado do cliente para drilldown devido à facilidade de uso.

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.

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::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, bool ignoreTransparent);

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

member this.HitTest : int * int * bool -> System.Web.UI.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

Um sinalizador que determina se os elementos transparentes são ignorados.

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.

Importante

Para que esse método funcione corretamente, a IsMapEnabled propriedade deve ser definida falsecomo .

Esse método pode ser usado com o evento do lado do Click servidor quando você implementa o drilldown. No entanto, é altamente recomendável que você use mapas de imagens do lado do cliente para drilldown devido à facilidade de uso.

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.