Chart.HitTest Méthode

Définition

Espace de noms:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.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, 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.
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)	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.

Remarques

Appelez cette méthode pour déterminer l’élément de graphique, 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, MouseDown ) pour déterminer l’élément de graphique sur lequel l’utilisateur final a cliqué. Les coordonnées de souris X et Y obtenues à partir des paramètres d’événement sont ensuite utilisées pour les x valeurs de paramètre 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.

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::Web::UI::DataVisualization::Charting::HitTestResult ^> ^ HitTest(int x, int y, bool ignoreTransparent, ... cli::array <System::Web::UI::DataVisualization::Charting::ChartElementType> ^ requestedElement);

public System.Web.UI.DataVisualization.Charting.HitTestResult[] HitTest (int x, int y, bool ignoreTransparent, params System.Web.UI.DataVisualization.Charting.ChartElementType[] requestedElement);

member this.HitTest : int * int * bool * System.Web.UI.DataVisualization.Charting.ChartElementType[] -> System.Web.UI.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

Un indicateur qui indique que les éléments transparents doivent être ignorés.

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 MouseDown, pour déterminer l’élément de jauge sur lequel l’utilisateur final a cliqué. Les coordonnées de souris X et Y obtenues à partir des paramètres d’événement sont ensuite utilisées pour les valeurs de 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.

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::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, System::Web::UI::DataVisualization::Charting::ChartElementType requestedElement);

public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest (int x, int y, System.Web.UI.DataVisualization.Charting.ChartElementType requestedElement);

member this.HitTest : int * int * System.Web.UI.DataVisualization.Charting.ChartElementType -> System.Web.UI.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 relatives à l'élément de graphique se trouvant, le cas échéant, à 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é.

Important

Pour que cette méthode fonctionne correctement, la IsMapEnabled propriété doit avoir la valeur false.

Cette méthode peut être utilisée avec l’événement Click côté serveur lorsque vous implémentez l’extraction. Toutefois, il est vivement recommandé d’utiliser des cartes d’images côté client pour l’exploration en raison de la facilité d’utilisation.

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.

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::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y);

public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest (int x, int y);

member this.HitTest : int * int -> System.Web.UI.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é.

Important

Pour que cette méthode fonctionne correctement, la IsMapEnabled propriété doit avoir la valeur false.

Cette méthode peut être utilisée avec l’événement Click côté serveur lorsque vous implémentez l’extraction. Toutefois, il est vivement recommandé d’utiliser des cartes d’images côté client pour l’exploration en raison de la facilité d’utilisation.

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.

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::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, bool ignoreTransparent);

public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest (int x, int y, bool ignoreTransparent);

member this.HitTest : int * int * bool -> System.Web.UI.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

Indicateur qui détermine si les éléments transparents sont ignorés.

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

Important

Pour que cette méthode fonctionne correctement, la IsMapEnabled propriété doit avoir la valeur false.

Cette méthode peut être utilisée avec l’événement Click côté serveur lorsque vous implémentez l’extraction. Toutefois, il est vivement recommandé d’utiliser des cartes d’images côté client pour l’exploration en raison de la facilité d’utilisation.

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.