Condividi tramite


messaggio TVM_GETISEARCHSTRING

Recupera la stringa di ricerca incrementale per un controllo di visualizzazione albero. Il controllo visualizzazione albero usa la stringa di ricerca incrementale per selezionare un elemento in base ai caratteri digitati dall'utente. È possibile inviare questo messaggio in modo esplicito o utilizzando la macro TreeView_GetISearchString .

Parametri

wParam

Deve essere zero.

lParam

Puntatore al buffer che riceve la stringa di ricerca incrementale.

Valore restituito

Restituisce il numero di caratteri nella stringa di ricerca incrementale.

Commenti

Avviso di sicurezza: L'uso di questo messaggio potrebbe compromettere erroneamente la sicurezza del programma. È necessario allocare un buffer sufficientemente grande per contenere la stringa. Chiamare prima di tutto il messaggio passando NULL in lParam. Viene restituito il numero di caratteri, escluso NULL, necessari. Chiamare quindi il messaggio una seconda volta per recuperare la stringa. Prima di continuare, vedere Considerazioni sulla sicurezza: Controlli di Microsoft Windows .

Se il controllo visualizzazione albero non è in modalità di ricerca incrementale, il valore restituito è zero.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Intestazione
Commctrl.h
Nomi Unicode e ANSI
TVM_GETISEARCHSTRINGW (Unicode) e TVM_GETISEARCHSTRINGA (ANSI)