CListCtrl::SetItemState

Modifica lo stato di un elemento in un controllo visualizzazione elenco.

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

Parametri

  • nItem
    Indice dell'elemento con lo stato deve essere impostato.

  • pItem
    Indirizzo di una struttura LVITEM, come descritto in Windows SDK.Il membro stateMask della struttura specifica che i bit di stato da modificare e il membro state di struttura contiene i nuovi valori per i bit.Gli altri membri vengono ignorati.

  • nState
    Nuovi valori per i bit di stato.Per un elenco di valori possibili, vedere CListCtrl::GetNextItem e LVITEM membro di stato.

  • nMask
    Specificare maschera di bit di stato da modificare.Questo valore corrisponde al membro di stateMask della struttura LVITEM.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario zero.

Note

"Stato" di un elemento rappresenta un valore che specifica la disponibilità dell'elemento, indica le azioni utente, oppure riflette lo stato dell'elemento.Le modifiche di controllo visualizzazione elenco alcuni indicano i bit, come quando l'utente seleziona un elemento.Un'applicazione potrebbe cambiare altri bit di stato per disabilitare o nascondere l'elemento, o per specificare un'immagine o un'immagine di stato sovrapposti.

Esempio

Vedere l'esempio relativo CListCtrl::GetTopIndex.

Requisiti

Header: afxcmn.h

Vedere anche

Riferimenti

Classe di CListCtrl

Grafico della gerarchia

CListCtrl::GetItemState