macro TreeView_SelectSetFirstVisible (commctrl.h)

Scorre verticalmente il controllo visualizzazione albero per assicurarsi che l'elemento specificato sia visibile. Se possibile, l'elemento specificato diventa il primo elemento visibile nella parte superiore della finestra del controllo. È possibile utilizzare questa macro o la macro TreeView_Select oppure inviare il messaggio di TVM_SELECTITEM in modo esplicito.

Sintassi

BOOL TreeView_SelectSetFirstVisible(
   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

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.

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_SelectSetFirstVisible equivale all'invio del messaggio di TVM_SELECTITEM con il relativo flag di parametro impostato sul valore TVGN_FIRSTVISIBLE.

Fabbisogno