Partager via


CListCtrl::SetItemState

Change l'état d'un élément dans un contrôle liste view.

BOOL SetItemState( 
   int nItem, 
   LVITEM* pItem  
); 
BOOL SetItemState( 
   int nItem, 
   UINT nState, 
   UINT nMask  
);

Paramètres

  • nItem
    Index de l'élément dont l'état doit être défini.

  • pItem
    Adresse d'une structure de LVITEM , comme décrit dans Kit de développement logiciel Windows. Le membre de stateMask de la structure qui spécifie l'état des bits pour modifier, et le membre de état de la structure contient les nouvelles valeurs pour ces bits. Les autres membres sont ignorés.

  • nState
    Nouvelles valeurs des bits d'état. Pour obtenir la liste des valeurs possibles, consultez CListCtrl::GetNextItem et le membre d'état de LVITEM .

  • nMask
    Masquer spécifier que l'état des bits pour modifier. Cette valeur correspond au membre de stateMask de la structure de LVITEM .

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon zéro.

Notes

« État » d'un élément est une valeur qui spécifie la disponibilité de l'élément, indique les actions utilisateur, ou sinon reflète l'état de l'élément. Un contrôle liste view modifie certains bits d'état, par exemple lorsque l'utilisateur sélectionne un élément. Une application peut modifier d'autres bits d'état pour désactiver ou masquer l'élément, ou pour spécifier une image de superposition ou pour déclarer l'image.

Exemple

Consultez l'exemple pour CListCtrl::GetTopIndex.

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

CListCtrl, classe

Graphique de la hiérarchie

CListCtrl::GetItemState