macro TreeView_GetCheckState (commctrl.h)

Ottiene lo stato di controllo dell'elemento specificato. È anche possibile usare direttamente il messaggio di TVM_GETITEMSTATE.

Sintassi

UINT TreeView_GetCheckState(
   HWND      hwndTV,
   HTREEITEM hti
);

Parametri

hwndTV

Tipo: HWND

Handle per il controllo visualizzazione albero.

hti

Tipo: HTREEITEM

Handle per l'elemento.

Valore restituito

Tipo: UINT

Rendiconto:

Codice restituito	Descrizione
Quadrettato	1
Deselezionata	0
Nessuna immagine casella di controllo	-1

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

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h