Chart.HitTest Méthode

Définition

Espace de noms:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Détermine l'élément de graphique, le cas échéant, localisé à un point défini par les coordonnées X et Y données.

Surcharges

HitTest(Int32, Int32)	Détermine l'élément de graphique, le cas échéant, localisé à un point défini par les coordonnées X et Y données.
HitTest(Int32, Int32, Boolean)	Détermine l'élément de graphique se trouvant, le cas échéant, en un point défini par les coordonnées X et Y spécifiées. Les éléments transparents peuvent éventuellement être ignorés.
HitTest(Int32, Int32, ChartElementType)	Détermine si un élément de graphique d'un type donné est situé en un point défini par les coordonnées X et Y spécifiées.
HitTest(Int32, Int32, Boolean, ChartElementType[])	Détermine si un élément de graphique de l’un des types spécifiés se trouve à un point défini par les coordonnées X et Y données.

Remarques

Appelez cette méthode pour déterminer l’élément de graphique, le cas échéant, situé à un point spécifié.

Cette méthode est souvent utilisée dans un événement lié à la souris , par exemple, OnMouseDown pour déterminer l’élément de graphique sur lequel l’utilisateur final a cliqué. Les coordonnées de la souris X et Y obtenues à partir des paramètres d’événement sont ensuite utilisées pour les x valeurs de paramètre de y cet appel de méthode.

Les propriétés de l’objet HitTestResult retourné peuvent ensuite être utilisées pour déterminer l’élément de graphique qui a été cliqué ; l’objet HitTestResult fournit également une instance de l’objet réel sélectionné, le cas échéant.

HitTest(Int32, Int32)

Détermine l'élément de graphique, le cas échéant, localisé à un point défini par les coordonnées X et Y données.

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

Paramètres

x

Int32

Valeur de la coordonnée X du point sur lequel l'utilisateur a cliqué.

y

Int32

Valeur de la coordonnée Y du point sur lequel l'utilisateur a cliqué.

Retours

HitTestResult

Objet HitTestResult qui fournit des informations relative à l'élément de graphique, le cas échéant, qui se trouve à l'emplacement spécifié.

Remarques

Appelez cette méthode pour déterminer l’élément de graphique, le cas échéant, qui se trouve à un point spécifié.

Les propriétés de l’objet HitTestResult retourné peuvent ensuite être utilisées pour déterminer l’élément de graphique qui a été cliqué ; l’objet HitTestResult fournit également une instance de l’objet réel sélectionné, le cas échéant.

HitTest(Int32, Int32, Boolean)

Détermine l'élément de graphique se trouvant, le cas échéant, en un point défini par les coordonnées X et Y spécifiées. Les éléments transparents peuvent éventuellement être ignorés.

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

Paramètres

x

Int32

Valeur de la coordonnée X du point sur lequel l'utilisateur a cliqué.

y

Int32

Valeur de la coordonnée Y du point sur lequel l'utilisateur a cliqué.

ignoreTransparent

Boolean

true pour ignorer les éléments transparents ; sinon, false.

Retours

HitTestResult

Objet HitTestResult qui fournit des informations relative à l'élément de graphique, le cas échéant, qui se trouve à l'emplacement spécifié.

Remarques

Appelez cette méthode pour déterminer l’élément de graphique, le cas échéant, qui se trouve à un point spécifié.

Pour ignorer les éléments transparents, définissez le paramètre truesur ignoreTransparent .

Les propriétés de l’objet HitTestResult retourné peuvent ensuite être utilisées pour déterminer l’élément de graphique qui a été cliqué ; l’objet HitTestResult fournit également une instance de l’objet réel sélectionné, le cas échéant.

HitTest(Int32, Int32, ChartElementType)

Détermine si un élément de graphique d'un type donné est situé en un point défini par les coordonnées X et Y spécifiées.

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

Paramètres

x

Int32

Valeur de la coordonnée X du point sur lequel l'utilisateur a cliqué.

y

Int32

Valeur de la coordonnée Y du point sur lequel l'utilisateur a cliqué.

requestedElement

ChartElementType

Indicateur qui détermine le type d'élément de graphique à tester.

Retours

HitTestResult

Objet HitTestResult qui fournit des informations relative à l'élément de graphique, le cas échéant, qui se trouve à l'emplacement spécifié.

Remarques

Appelez cette méthode pour déterminer si un élément de graphique du type donné se trouve à un point spécifié.

Les propriétés de l’objet HitTestResult retourné peuvent ensuite être utilisées pour déterminer l’élément de graphique qui a été cliqué ; l’objet HitTestResult fournit également une instance de l’objet réel sélectionné, le cas échéant.

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

Détermine si un élément de graphique de l’un des types spécifiés se trouve à un point défini par les coordonnées X et Y données.

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()

Paramètres

x

Int32

Coordonnée X du point de données spécifié.

y

Int32

Coordonnée Y du point de données spécifié.

ignoreTransparent

Boolean

true pour ignorer les éléments transparents ; sinon, false.

requestedElement

ChartElementType[]

Un tableau d’objets ChartElementType qui spécifie les types à tester pour filtrer le résultat. Dans le cas contraire, la vérification des types d’éléments sera ignorée et tous les types d’éléments seront valides.

Retours

HitTestResult[]

Un tableau d’objets HitTestResult qui fournit des informations sur l’élément graphique trouvé le cas échéant à l’emplacement spécifié. Le tableau contient au moins un élément, qui peut être Nothing. Les objets dans le résultat sont triés de haut en bas des différentes couches de contrôle.

Remarques

Appelez cette méthode pour déterminer l’élément de jauge, le cas échéant, qui se trouve à un point spécifié. Cette méthode est souvent utilisée dans un événement lié à la souris, par exemple, OnMouseDownpour déterminer l’élément de jauge sur lequel l’utilisateur final a cliqué. Les coordonnées de la souris X et Y obtenues à partir des paramètres d’événement sont ensuite utilisées pour les valeurs des paramètres X et Y de cet appel de méthode.

Les propriétés de l’objet retourné HitTestResult peuvent ensuite être utilisées pour déterminer l’élément de graphique qui a été cliqué ; l’objet HitTestResult fournit également une instance de l’objet réel sélectionné, le cas échéant.