Éléments de rappel et masque de rappel

  • Article

Pour chacun de ses éléments, un contrôle d’affichage de liste stocke généralement le texte de l’étiquette, l’index de liste d’images des icônes de l’élément et un ensemble d’indicateurs de bits pour l’état de l’élément. Vous pouvez définir des éléments individuels en tant qu’éléments de rappel, ce qui est utile si votre application stocke déjà certaines des informations d’un élément.

Vous définissez un élément en tant qu’élément de rappel en spécifiant les valeurs appropriées pour les membres et les pszText membres de la LVITEM structure (voir CListCtrl ::GetItem).iImage Si l’application conserve le texte de l’élément ou du sous-élément, spécifiez la valeur LPSTR_TEXTCALLBACK pour le pszText membre. Si l’application effectue le suivi de l’icône de l’élément, spécifiez la valeur I_IMAGECALLBACK pour le iImage membre.

En plus de définir des éléments de rappel, vous pouvez également modifier le masque de rappel du contrôle. Ce masque 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 suit tous les états d’élément. Pour modifier ce comportement par défaut, initialisez le masque sur n’importe quelle combinaison des valeurs suivantes :

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

Pour plus d’informations sur la récupération et la définition de ce masque, consultez CListCtrl ::GetCallbackMask et CListCtrl ::SetCallbackMask.

Voir aussi

Utilisation de CListCtrl
Contrôles