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 hay alguno, que se encuentra en un punto definido por las coordenadas X e Y dadas.

Sobrecargas

HitTest(Int32, Int32)	Determina el elemento de gráfico, si hay alguno, que se encuentra en un punto definido por las coordenadas X e Y dadas.
HitTest(Int32, Int32, Boolean)	Determina el elemento de gráfico, si hay alguno, que se encuentra en un punto definido por las coordenadas X e Y dadas. Se pueden pasar por alto los elementos transparentes opcionalmente.
HitTest(Int32, Int32, ChartElementType)	Determina si un elemento de gráfico de un tipo determinado se encuentra en un punto definido por las 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 la X e Y dadas.

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 x valores de parámetro y y de esta llamada al método.

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

HitTest(Int32, Int32)

Determina el elemento de gráfico, si hay alguno, que se encuentra en un punto definido por las 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

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

y

Int32

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

Devoluciones

HitTestResult

Un objeto HitTestResult que proporciona información relativa al elemento de gráfico que está en la ubicación especificada, si hay alguno.

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 HitTestResult objeto que se devuelve se pueden usar para determinar en qué elemento de gráfico se hizo clic; el HitTestResult objeto también proporciona una instancia del objeto real seleccionado, si existe.

HitTest(Int32, Int32, Boolean)

Determina el elemento de gráfico, si hay alguno, que se encuentra en un punto definido por las coordenadas X e Y dadas. Se pueden pasar por alto los elementos transparentes 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 la coordenada X del punto en el que el usuario ha hecho clic.

y

Int32

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

ignoreTransparent

Boolean

true para omitir elementos transparentes; si no, false.

Devoluciones

HitTestResult

Un objeto HitTestResult que proporciona información relativa al elemento de gráfico que está en la ubicación especificada, si hay alguno.

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 ignoreTransparent parámetro en true.

Las propiedades del HitTestResult objeto que se devuelve se pueden usar para determinar en qué elemento de gráfico se hizo clic; el HitTestResult objeto 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 las 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 la coordenada X del punto en el que el usuario ha hecho clic.

y

Int32

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

requestedElement

ChartElementType

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

Devoluciones

HitTestResult

Un objeto HitTestResult que proporciona información relativa al elemento de gráfico que está en la ubicación especificada, si hay alguno.

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 HitTestResult objeto que se devuelve se pueden usar para determinar en qué elemento de gráfico se hizo clic; el HitTestResult objeto 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 la 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

Coordenada X del punto de datos especificado.

y

Int32

Coordenada Y del punto de datos especificado.

ignoreTransparent

Boolean

true para omitir elementos transparentes; si no, false.

requestedElement

ChartElementType[]

Matriz de objetos ChartElementType que especifica los tipos que se van a probar para filtrar el resultado. Si se omite, se pasará por alto la comprobación de los tipos de elemento y todos los tipos de elemento serán válidos.

Devoluciones

HitTestResult[]

Matriz de objetos HitTestResult que proporciona información sobre el elemento de gráfico, si hay alguno, situado 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 los distintos niveles del 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 en qué elemento de gráfico se hizo clic; el HitTestResult objeto también proporciona una instancia del objeto real seleccionado, si existe.