macro TreeView_SelectItem (commctrl.h)

Seleziona l'elemento di visualizzazione albero specificato. È possibile utilizzare questa macro o la macro TreeView_Select oppure inviare il messaggio di TVM_SELECTITEM in modo esplicito.

Sintassi

BOOL TreeView_SelectItem(
   HWND      hwnd,
   HTREEITEM hitem
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione albero.

hitem

Tipo: HTREEITEM

Handle per un elemento. Se il parametro hitem è NULL, il controllo è impostato su nessun elemento selezionato.

Valore restituito

Tipo: BOOL

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

Quando si chiama la macro TreeView_SelectItem, la finestra padre del controllo riceve i codici di notifica TVN_SELCHANGING e TVN_SELCHANGED. Inoltre, se l'elemento specificato è figlio di un elemento padre compresso, l'elenco di elementi figlio dell'elemento padre viene espanso per visualizzare l'elemento specificato. In questo caso, la finestra padre riceve i codici di notifica TVN_ITEMEXPANDING e TVN_ITEMEXPANDED.

L'utilizzo della macro TreeView_SelectItem equivale all'invio del messaggio di TVM_SELECTITEM con il relativo flag parametro impostato sul valore TVGN_CARET.

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