macro TreeView_GetISearchString (commctrl.h)

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

Sintassi

BOOL TreeView_GetISearchString(
   HWND   hwndTV,
   LPTSTR lpsz
);

Parametri

hwndTV

Tipo: HWND

Handle per il controllo visualizzazione albero.

lpsz

Tipo: LPTSTR

Puntatore al buffer che riceve la stringa di ricerca incrementale.

Valore restituito

Tipo: BOOL

Restituisce true se la stringa viene recuperata; false in caso contrario.

Osservazioni

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

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

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