Chart.HitTest Método

Definición

Espacio de nombres:

System.Windows.Forms.DataVisualization.Charting

Ensamblado:

System.Windows.Forms.DataVisualization.dll

Determina el elemento de gráfico, si existe, que se encuentra en un punto definido por las coordenadas X e Y especificadas.

Sobrecargas

HitTest(Int32, Int32)	Determina el elemento de gráfico, si existe, que se encuentra en un punto definido por las coordenadas X e Y especificadas.
HitTest(Int32, Int32, Boolean)	Determina el elemento de gráfico, si existe, que se encuentra en un punto definido por coordenadas X e Y dadas. Los elementos transparentes se pueden omitir opcionalmente.
HitTest(Int32, Int32, ChartElementType)	Determina si un elemento de gráfico de un tipo determinado se encuentra en un punto definido por coordenadas X e Y dadas.
HitTest(Int32, Int32, Boolean, ChartElementType[])	Determina si un elemento de gráfico que es uno de los tipos especificados se encuentra en un punto definido por las coordenadas X e Y especificadas.

Comentarios

Llame a este método para determinar el elemento de gráfico, si existe, que se encuentra en un punto especificado.

Este método se usa a menudo en algún evento relacionado con el mouse (por ejemplo, OnMouseDown) para determinar qué elemento de gráfico ha hecho clic el usuario final. Las coordenadas del mouse X e Y obtenidas de los parámetros de evento se usan para los valores de parámetro de x y y de esta llamada al método.

Las propiedades del objeto HitTestResult que se devuelve se pueden usar para determinar qué elemento de gráfico se hizo clic; el objeto HitTestResult también proporciona una instancia del objeto real seleccionado, si existe.

HitTest(Int32, Int32)

Determina el elemento de gráfico, si existe, que se encuentra en un punto definido por las coordenadas X e Y especificadas.

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

Valor de coordenada X del punto en el que el usuario ha clic.

y

Int32

Valor de coordenada Y del punto en el que ha clic el usuario.

Devoluciones

HitTestResult

Objeto HitTestResult, que proporciona información sobre el elemento de gráfico, si existe, que se encuentra en la ubicación especificada.

Comentarios

Llame a este método para determinar el elemento de gráfico, si existe, que se encuentra en un punto especificado.

Las propiedades del objeto HitTestResult que se devuelve se pueden usar para determinar qué elemento de gráfico se hizo clic; el objeto HitTestResult también proporciona una instancia del objeto real seleccionado, si existe.

HitTest(Int32, Int32, Boolean)

Determina el elemento de gráfico, si existe, que se encuentra en un punto definido por coordenadas X e Y dadas. Los elementos transparentes se pueden omitir opcionalmente.

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

Valor de coordenada X del punto en el que el usuario ha clic.

y

Int32

Valor de coordenada Y del punto en el que el usuario ha clic.

ignoreTransparent

Boolean

true omitir elementos transparentes; de lo contrario, false.

Devoluciones

HitTestResult

Objeto HitTestResult, que proporciona información sobre el elemento de gráfico, si existe, que se encuentra en la ubicación especificada.

Comentarios

Llame a este método para determinar el elemento de gráfico, si existe, que se encuentra en un punto especificado.

Para pasar por alto los elementos transparentes, establezca el parámetro ignoreTransparent en true.

Las propiedades del objeto HitTestResult que se devuelve se pueden usar para determinar qué elemento de gráfico se hizo clic; el objeto HitTestResult también proporciona una instancia del objeto real seleccionado, si existe.

HitTest(Int32, Int32, ChartElementType)

Determina si un elemento de gráfico de un tipo determinado se encuentra en un punto 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

Valor de coordenada X del punto en el que el usuario ha clic.

y

Int32

Valor de coordenada Y del punto en el que el usuario ha clic.

requestedElement

ChartElementType

Marca que determina el tipo de elemento de gráfico que se va a probar.

Devoluciones

HitTestResult

Objeto HitTestResult, que proporciona información sobre el elemento de gráfico, si existe, que se encuentra en la ubicación especificada.

Comentarios

Llame a este método para determinar si un elemento de gráfico del tipo especificado se encuentra en un punto especificado.

Las propiedades del objeto HitTestResult que se devuelve se pueden usar para determinar qué elemento de gráfico se hizo clic; el objeto HitTestResult también proporciona una instancia del objeto real seleccionado, si existe.

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

Determina si un elemento de gráfico que es uno de los tipos especificados se encuentra en un punto definido por las coordenadas X e Y especificadas.

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

Coordenada X del punto de datos especificado.

y

Int32

Coordenada Y del punto de datos especificado.

ignoreTransparent

Boolean

true omitir elementos transparentes; de lo contrario, false.

requestedElement

ChartElementType[]

Matriz de ChartElementType objetos que especifican los tipos para los que se van a probar, con el fin de filtrar el resultado. Si se omite, se omitirá la comprobación de los tipos de elemento y todos los tipos de elementos serán válidos.

Devoluciones

HitTestResult[]

Matriz de objetos HitTestResult que proporciona información sobre el elemento de gráfico, si existe, que se encuentra en la ubicación especificada. La matriz contiene al menos un elemento, que puede ser Nothing. Los objetos del resultado se ordenan de la parte superior a la parte inferior de diferentes capas de control.

Comentarios

Llame a este método para determinar el elemento de medidor, si existe, que se encuentra en un punto especificado. Este método se usa a menudo en algún evento relacionado con el mouse, por ejemplo, OnMouseDown, para determinar qué elemento de medidor ha hecho clic el usuario final. Las coordenadas del mouse X e Y obtenidas de los parámetros de evento se usan para los valores de parámetro X e Y de esta llamada al método.

Las propiedades del objeto devuelto HitTestResult se pueden usar para determinar qué elemento de gráfico se hizo clic; el objeto HitTestResult también proporciona una instancia del objeto real seleccionado, si existe.