macro ListView_GetItemState (commctrl.h)

Article
10/24/2024

Obtient l’état d’un élément d’affichage de liste. Vous pouvez utiliser cette macro ou envoyer explicitement le message LVM_GETITEMSTATE.

Syntaxe

UINT ListView_GetItemState(
   HWND hwndLV,
   int  i,
   UINT mask
);

Paramètres

hwndLV

Type : HWND

Handle du contrôle list-view.

i

Type : int

Index de l’élément d’affichage de liste.

mask

Type : UINT

Informations d’état à récupérer. Ce paramètre peut être une combinaison des valeurs suivantes :

Valeur	Signification
LVIS_CUT	L’élément est marqué pour une opération couper-coller.
LVIS_DROPHILITED	L’élément est mis en surbrillance en tant que cible de glisser-déplacer.
LVIS_FOCUSED	L’élément a le focus. Il est donc entouré d’un rectangle de focus standard. Bien que plusieurs éléments puissent être sélectionnés, un seul élément peut avoir le focus.
LVIS_SELECTED	L’élément est sélectionné. L’apparence d’un élément sélectionné dépend du focus et des couleurs système utilisées pour la sélection.
LVIS_OVERLAYMASK	Utilisez ce masque pour récupérer l’index d’image de superposition de l’élément.
LVIS_STATEIMAGEMASK	Utilisez ce masque pour récupérer l’index d’image d’état de l’élément.

Valeur de retour

Type : UINT

Retourne l’état actuel de l’élément spécifié. Les seuls bits valides dans la valeur de retour sont ceux qui correspondent aux bits définis dans le paramètre mask.

Remarques

Les informations d’état d’un élément incluent un ensemble d’indicateurs de bits ainsi que des index de liste d’images qui indiquent l’image d’état de l’élément et l’image de superposition.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h

Voir aussi

ListView_SetItemState

Partager via