Chart.HitTest Méthode

Définition

Espace de noms:: System.Windows.Forms.DataVisualization.Charting

Assembly:: System.Windows.Forms.DataVisualization.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Surcharges

Nom	Description
HitTest(Int32, Int32)	Détermine l’élément de graphique, le cas échéant, situé à un point défini par les coordonnées X et Y données.
HitTest(Int32, Int32, Boolean)	Détermine l’élément de graphique, le cas échéant, situé à un point défini par des coordonnées X et Y donné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é se trouve à un point défini par des coordonnées X et Y données.
HitTest(Int32, Int32, Boolean, ChartElementType[])	Détermine si un élément de graphique qui est 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 certains événements liés à 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, situé à 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 coordonnée X du point sur laquelle l’utilisateur a cliqué.

y: Int32

Valeur de coordonnée Y du point sur laquelle l’utilisateur a cliqué.

Retours

HitTestResult

Objet HitTestResult , qui fournit des informations sur 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é.

S’applique à

HitTest(Int32, Int32, Boolean)

Détermine l’élément de graphique, le cas échéant, situé à un point défini par des coordonnées X et Y donné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 coordonnée X du point sur lequel l’utilisateur a cliqué.

y: Int32

Valeur de 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 sur 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 ignoreTransparent paramètre sur true.

S’applique à

HitTest(Int32, Int32, ChartElementType)

Détermine si un élément de graphique d’un type donné se trouve à un point défini par des coordonnées X et Y donné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 coordonnée X du point sur lequel l’utilisateur a cliqué.

y: Int32

Valeur de 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 sur 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é.

S’applique à

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

Détermine si un élément de graphique qui est 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 pour le point de données spécifié.

y: Int32

Coordonnée Y pour le point de données spécifié.

ignoreTransparent: Boolean

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

requestedElement: ChartElementType[]

Tableau d’objets ChartElementType qui spécifient les types à tester, afin de filtrer le résultat. En cas d’omission, la vérification des types d’éléments est ignorée et tous les types d’éléments sont valides.

Retours

HitTestResult[]

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

Remarques

Appelez cette méthode pour déterminer l’élément de jauge, 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, 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 quel élément de graphique a été cliqué ; l’objet HitTestResult fournit également une instance de l’objet réel sélectionné, le cas échéant.

S’applique à

Commentaires

Cette page a-t-elle été utile ?