Chart.HitTest Método

Definição

Espaço de Nomes:: System.Windows.Forms.DataVisualization.Charting

Assemblagem:: System.Windows.Forms.DataVisualization.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Determina o elemento do mapa, se existir, que está localizado num ponto definido pelas coordenadas X e Y dadas.

Sobrecargas

Name	Description
HitTest(Int32, Int32)	Determina o elemento do mapa, se existir, que está localizado num ponto definido pelas coordenadas X e Y dadas.
HitTest(Int32, Int32, Boolean)	Determina o elemento do mapa, se existir, que está localizado num ponto definido por coordenadas X e Y dadas. Elementos transparentes podem ser opcionalmente ignorados.
HitTest(Int32, Int32, ChartElementType)	Determina se um elemento do mapa de um dado tipo está localizado num ponto definido por coordenadas X e Y dadas.
HitTest(Int32, Int32, Boolean, ChartElementType[])	Determina se um elemento do mapa que é um dos tipos especificados está localizado num ponto definido pelas coordenadas X e Y dadas.

Observações

Chame este método para determinar o elemento do mapa, se existir, que está localizado num ponto especificado.

Este método é frequentemente usado em algum evento relacionado com o rato – por exemplo, OnMouseDown – para determinar em que elemento do gráfico o utilizador final clicou. As coordenadas X e Y do rato obtidas a partir dos parâmetros do evento são então usadas para os x valores dos parâmetros e y desta chamada de método.

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

HitTest(Int32, Int32)

Determina o elemento do mapa, se existir, que está localizado num ponto definido pelas coordenadas X e Y dadas.

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

y: Int32

O valor da coordenada Y do ponto em que o utilizador clicou.

Devoluções

HitTestResult

Um HitTestResult objeto, que fornece informação relativa ao elemento do mapa, se existir, que está na localização especificada.

Observações

Chame este método para determinar o elemento do mapa, se existir, que está localizado num ponto especificado.

Aplica-se a

HitTest(Int32, Int32, Boolean)

Determina o elemento do mapa, se existir, que está localizado num ponto definido por coordenadas X e Y dadas. Elementos transparentes podem ser opcionalmente 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 das coordenadas X do ponto em que o utilizador clicou.

y: Int32

O valor da coordenada Y do ponto em que o utilizador clicou.

ignoreTransparent: Boolean

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

Devoluções

HitTestResult

Um HitTestResult objeto, que fornece informação relativa ao elemento do mapa, se existir, que está na localização especificada.

Observações

Chame este método para determinar o elemento do mapa, se existir, que está localizado num ponto especificado.

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

Aplica-se a

HitTest(Int32, Int32, ChartElementType)

Determina se um elemento do mapa de um dado tipo está localizado num ponto definido por coordenadas X e Y dadas.

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 das coordenadas X do ponto em que o utilizador clicou.

y: Int32

O valor da coordenada Y do ponto em que o utilizador clicou.

requestedElement: ChartElementType

Um flag que determina o tipo de elemento do mapa a ser testado.

Devoluções

HitTestResult

Um HitTestResult objeto, que fornece informação relativa ao elemento do mapa, se existir, que está na localização especificada.

Observações

Chame este método para determinar se um elemento gráfico do tipo dado está localizado num ponto especificado.

Aplica-se a

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

Determina se um elemento do mapa que é um dos tipos especificados está localizado num ponto definido pelas coordenadas X e Y dadas.

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

y: Int32

A coordenada Y para o ponto de dados especificado.

ignoreTransparent: Boolean

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

requestedElement: ChartElementType[]

Um array de ChartElementType objetos que especifica os tipos a testar, para filtrar o resultado. Se for omitido, a verificação dos tipos de elementos será ignorada e todos os tipos de elementos serão válidos.

Devoluções

HitTestResult[]

Um array de HitTestResult objetos que fornece informação sobre o elemento do mapa, se existir, encontrado na localização especificada. O array contém pelo menos um elemento, que pode ser Nothing. Os objetos no resultado estão organizados do topo para o fundo em diferentes camadas de controlo.

Observações

Chame este método para determinar o elemento de calibre, se existir, que está localizado num ponto especificado. Este método é frequentemente usado em algum evento relacionado com o rato, por exemplo, OnMouseDown, para determinar em que elemento de medição o utilizador final clicou. As coordenadas X e Y do rato obtidas a partir dos parâmetros do evento são então usadas para os valores dos parâmetros X e Y desta chamada de método.

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

Aplica-se a

Comentários

Esta página foi útil?