Chart.HitTest Método

Definição

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

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, 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.
HitTest(Int32, Int32, ChartElementType)	Determina se um elemento de gráfico de um determinado tipo está localizado em um ponto definido pelas coordenadas X e Y fornecidas.
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.

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 usadas para os valores e y parâmetros x 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 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::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 para o ponto de dados especificado.

ignoreTransparent

Boolean

Um sinalizador que indica que elementos transparentes devem ser ignorados.

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, 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 se um elemento de gráfico de um determinado tipo está localizado em um ponto definido pelas coordenadas X e Y fornecidas.

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 HitTestResult objeto que fornece informações sobre o elemento de gráfico, se houver, encontrado 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.

Importante

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

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 de gráfico, se houver, que está localizado em um ponto definido pelas coordenadas X e Y fornecidas.

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 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.

Importante

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

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 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::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 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.

Importante

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

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.