macro TreeView_SetCheckState (commctrl.h)

Imposta l'immagine dello stato dell'elemento su "checked" o "unchecked". È anche possibile usare direttamente il messaggio di TVM_SETITEM.

Sintassi

UINT TreeView_SetCheckState(
   HWND      hwndTV,
   HTREEITEM hti,
   BOOL      fCheck
);

Parametri

hwndTV

Tipo: HWND

Handle per il controllo visualizzazione albero.

hti

Tipo: HTREEITEM

Handle per l'elemento.

fCheck

Tipo: BOOL

Valore che indica quale immagine di stato viene visualizzata. Impostare fCheck su TRUE per visualizzare l'immagine dello stato selezionato o FALSE per visualizzare l'immagine deselezionata.

Valore restituito

Tipo: UINT

Il valore restituito non viene utilizzato.

Osservazioni

Un controllo visualizzazione albero può avere due elenchi di immagini. L'elenco di immagini normali archivia le immagini selezionate, non selezionate e sovrapposte. Le caselle di controllo vengono archiviate nell'elenco delle immagini di stato e visualizzate a sinistra dell'immagine normale corrispondente. Le immagini di stato vengono specificate da un indice in base uno. Un indice pari a zero indica che non esiste un'immagine di stato. Per informazioni su come gestire le immagini di visualizzazione ad albero, vedere elenchi di immagini Tree-View.

Se si desidera definire immagini di stato personalizzate, questa macro presuppone che le immagini controllate e deselezionate abbiano gli stessi indici dell'elenco di immagini standard: 1 per deselezionata e 2 per selezionata.

Fabbisogno