macro ListView_SetCallbackMask (commctrl.h)

Article
08/22/2023

Modifie le masque de rappel pour un contrôle d’affichage de liste. Vous pouvez utiliser cette macro ou envoyer le message LVM_SETCALLBACKMASK explicitement.

Syntaxe

void ListView_SetCallbackMask(
   hwnd,
   mask
);

Paramètres

hwnd

Type : HWND

Handle pour le contrôle d’affichage de liste.

mask

Type : UINT

Valeur du masque de rappel. Les bits du masque indiquent les états d’élément ou les images pour lesquels l’application stocke les données d’état actuelles. Cette valeur peut être n’importe quelle combinaison des constantes suivantes :

Valeur	Signification
LVIS_CUT	L’élément est marqué pour une opération de couper-coller.
LVIS_DROPHILITED	L’élément est mis en surbrillance en tant que cible glisser-déplacer.
LVIS_FOCUSED	L’élément a le focus.
LVIS_SELECTED	L'élément est sélectionné.
LVIS_OVERLAYMASK	L’application stocke l’index de liste d’images de l’image de superposition actuelle pour chaque élément.
LVIS_STATEIMAGEMASK	L’application stocke l’index de liste d’images de l’image d’état actuelle pour chaque élément.

Valeur de retour

None

Remarques

Le masque de rappel d’un contrôle d’affichage de liste est un ensemble d’indicateurs de bits qui spécifient les états d’élément pour lesquels l’application, plutôt que le contrôle, stocke les données actuelles. Le masque de rappel s’applique à tous les éléments du contrôle, contrairement à la désignation d’élément de rappel qui s’applique à un élément spécifique. Le masque de rappel est égal à zéro par défaut, ce qui signifie que le contrôle d’affichage de liste stocke toutes les informations sur l’état de l’élément. Après avoir créé un contrôle d’affichage de liste et initialisé ses éléments, vous pouvez utiliser la macro ListView_SetCallbackMask ou le message LVM_SETCALLBACKMASK pour modifier le masque de rappel. Pour récupérer le masque de rappel actuel, envoyez le message LVM_GETCALLBACKMASK .

Pour plus d’informations sur les images de superposition et les images d’état, consultez Listes d’images d’affichage de liste.

Pour plus d’informations sur les rappels d’affichage de liste, consultez Éléments de rappel et masque de rappel

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]
Plateforme cible	Windows
En-tête	commctrl.h

Voir aussi

LVN_GETDISPINFO

Partager via