macro TreeView_Select (commctrl.h)

  • Articolo

Seleziona l'elemento di visualizzazione albero specificato, scorre l'elemento nella visualizzazione o ridisegna l'elemento nello stile utilizzato per indicare la destinazione di un'operazione di trascinamento della selezione. È possibile utilizzare questa macro o le macro TreeView_SelectItem, TreeView_SelectSetFirstVisibleo TreeView_SelectDropTarget oppure è possibile inviare il messaggio di TVM_SELECTITEM in modo esplicito.

Sintassi

BOOL TreeView_Select(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

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.

code

Tipo: UINT

Flag azione. Questo parametro può essere uno dei valori seguenti:

Valore Significato
TVGN_CARET
 Imposta la selezione sull'elemento specificato. La finestra padre del controllo riceve i codici di notifica TVN_SELCHANGING e TVN_SELCHANGED.
TVGN_DROPHILITE
 Ridisegna l'elemento specificato nello stile utilizzato per indicare la destinazione di un'operazione di trascinamento della selezione.
TVGN_FIRSTVISIBLE
 Assicura che l'elemento specificato sia visibile e, se possibile, lo visualizzi nella parte superiore della finestra del controllo. I controlli visualizzazione albero visualizzano il numero di elementi che si adattano alla finestra. Se l'elemento specificato si trova nella parte inferiore della gerarchia di elementi del controllo, potrebbe non diventare il primo elemento visibile, a seconda del numero di elementi contenuti nella finestra.

Valore restituito

Tipo: BOOL

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

Osservazioni

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.

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