macro ListView_SetCallbackMask (commctrl.h)

Article
10/24/2024

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

Syntaxe

BOOL ListView_SetCallbackMask(
   HWND hwnd,
   UINT mask
);

Paramètres

hwnd

Type : HWND

Handle du contrôle list-view.

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 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.
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 la liste d’images de l’image d’état actuelle pour chaque élément.

Valeur de retour

Type : BOOL

Retourne TRUE en cas de réussite ou FALSE sinon.

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 d’état d’é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 la superposition d’images et d’images d’état, consultez List-View Listes d’images.

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

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

LVN_GETDISPINFO

Partager via