Structure LVHITTESTINFO (commctrl.h)

  • Article

Contient des informations sur un test d’accès. Cette structure a été étendue pour prendre en charge les tests d’accès au sous-élément. Il est utilisé en association avec les messages LVM_HITTEST et LVM_SUBITEMHITTEST et leurs macros associées. Cette structure remplace la structure LVHITTESTINFO .

Syntaxe

typedef struct tagLVHITTESTINFO {
  POINT pt;
  UINT  flags;
  int   iItem;
  int   iSubItem;
  int   iGroup;
} LVHITTESTINFO, *LPLVHITTESTINFO;

Membres

pt

Type : POINT

Position à tester, dans les coordonnées du client.

flags

Type : UINT

Variable qui reçoit des informations sur les résultats d’un test d’accès. Ce membre peut être une ou plusieurs des valeurs suivantes :

Vous pouvez utiliser LVHT_ABOVE, LVHT_BELOW, LVHT_TOLEFT et LVHT_TORIGHT pour déterminer s’il faut faire défiler le contenu d’un contrôle list-view. Deux de ces valeurs peuvent être combinées. Par exemple, si la position se trouve au-dessus et à gauche de la zone cliente, vous pouvez utiliser à la fois LVHT_ABOVE et LVHT_TOLEFT. 

Vous pouvez tester LVHT_ONITEM pour déterminer si une position spécifiée se trouve au-dessus d’un élément de liste. Cette valeur est une opération OR au niveau du bit sur LVHT_ONITEMICON, LVHT_ONITEMLABEL et LVHT_ONITEMSTATEICON.

Valeur Signification
LVHT_ABOVE
 La position se trouve au-dessus de la zone cliente du contrôle.
LVHT_BELOW
 La position se trouve sous la zone cliente du contrôle.
LVHT_NOWHERE
 La position se trouve à l’intérieur de la fenêtre cliente du contrôle list-view, mais elle ne se trouve pas sur un élément de liste.
LVHT_ONITEMICON
 La position se trouve sur l’icône d’un élément de liste.
LVHT_ONITEMLABEL
 La position se trouve sur le texte d’un élément de liste.
LVHT_ONITEMSTATEICON
 La position se trouve sur l’image d’état d’un élément de liste.
LVHT_TOLEFT
 La position se trouve à gauche de la zone cliente du contrôle list-view.
LVHT_TORIGHT
 La position se trouve à droite de la zone cliente du contrôle list-view.
LVHT_EX_GROUP_HEADER
 Windows Vista. Le point se trouve dans l’en-tête du groupe.
LVHT_EX_GROUP_FOOTER
 Windows Vista. Le point se trouve dans le pied de page du groupe.
LVHT_EX_GROUP_COLLAPSE
 Windows Vista. Le point se trouve dans le bouton réduire/développer du groupe.
LVHT_EX_GROUP_BACKGROUND
 Windows Vista. Le point se trouve dans la zone du groupe où les éléments sont affichés.
LVHT_EX_GROUP_STATEICON
 Windows Vista. Le point se trouve dans l’icône d’état du groupe.
LVHT_EX_GROUP_SUBSETLINK
 Windows Vista. Le point se trouve dans le lien de sous-ensemble du groupe.
LVHT_EX_GROUP
 Windows Vista. LVHT_EX_GROUP_BACKGROUND | LVHT_EX_GROUP_COLLAPSE | LVHT_EX_GROUP_FOOTER | LVHT_EX_GROUP_HEADER | LVHT_EX_GROUP_STATEICON | LVHT_EX_GROUP_SUBSETLINK.
LVHT_EX_ONCONTENTS
 Windows Vista. Le point se trouve dans le contenu de l’icône ou du texte de l’élément et non sur l’arrière-plan.
LVHT_EX_FOOTER
 Windows Vista. Le point se trouve dans le pied de page du contrôle list-view.

iItem

Type : int

Reçoit l’index de l’élément correspondant. Ou si vous testez un sous-élément, cette valeur représente l’élément parent du sous-élément.

iSubItem

Type : int

Version 4.70. Reçoit l’index du sous-élément correspondant. Lors du test d’accès à un élément, ce membre est égal à zéro.

iGroup

Type : int

Windows Vista. Index de groupe de l’accès à l’élément (lecture seule). Valide uniquement pour les données de propriétaire. Si le point se trouve dans un élément affiché dans plusieurs groupes, iGroup spécifie l’index de groupe de l’élément.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête commctrl.h