messaggio di TVM_SELECTITEM

Seleziona l'elemento della 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 inviare questo messaggio in modo esplicito o utilizzando la macro TreeView_Select, TreeView_SelectItem o TreeView_SelectDropTarget .

Parametri

wParam

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 visualizzazione albero 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.
TVSI_NOSINGLEEXPAND
Quando viene selezionato un singolo elemento, assicura che la visualizzazione albero non espande gli elementi figlio di tale elemento. Questa opzione è valida solo se utilizzata con il flag di TVGN_CARET.
Nota: Per usare questo flag, è necessario specificare un manifesto che specifica Comclt32.dll versione 6.0. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.

lParam

Handle per un elemento. Se lParam è NULL, il controllo viene impostato su nessun elemento selezionato.

Valore restituito

Restituisce TRUE se l'operazione riesce o FALSE in caso contrario.

Commenti

Se l'elemento specificato è l'elemento 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 del controllo 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 wParam impostato sul valore TVGN_CARET. L'utilizzo della macro TreeView_SelectDropTarget equivale all'invio del messaggio di TVM_SELECTITEM con wParam impostato sul valore TVGN_DROPHILITE. L'uso di TreeView_SelectSetFirstVisible equivale all'invio del messaggio di TVM_SELECTITEM con wParam impostato sul valore TVGN_FIRSTVISIBLE.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Intestazione
Commctrl.h