Chart.HitTest Méthode
Définition
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, 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
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.
S’applique à
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
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 true
sur 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.
S’applique à
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
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.
S’applique à
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
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.