LVM_GETISEARCHSTRING messaggio

Recupera la stringa di ricerca incrementale di un controllo di visualizzazione elenco. È possibile inviare questo messaggio in modo esplicito o usando la macro ListView_GetISearchString .

Parametri

wParam

Deve essere zero.

lParam

Puntatore a un buffer che riceve la stringa di ricerca incrementale. Per recuperare solo la lunghezza della stringa, impostare lParam su NULL.

Valore restituito

Restituisce il numero di caratteri nella stringa di ricerca incrementale, non incluso il carattere NULL terminante o zero se il controllo di visualizzazione elenco non è in modalità di ricerca incrementale.

Commenti

Avviso di sicurezza: L'uso di questo messaggio in modo errato potrebbe compromettere la sicurezza del programma. Questo messaggio non fornisce un modo per conoscere le dimensioni del buffer. Se si usa questo messaggio, chiamare prima il messaggio passando NULLnell'oggetto lParam, questo restituisce il numero di caratteri, escluso NULL richiesto. Chiamare quindi il messaggio una seconda volta per recuperare la stringa. È consigliabile esaminare le considerazioni sulla sicurezza: Controlli Di Microsoft Windows prima di continuare.

La stringa di ricerca incrementale è la sequenza di caratteri che l'utente digita mentre la visualizzazione elenco ha lo stato attivo di input. Ogni volta che l'utente digita un carattere, il sistema aggiunge il carattere alla stringa di ricerca e quindi cerca un elemento corrispondente. Se il sistema trova una corrispondenza, seleziona l'elemento e, se necessario, lo scorre nella visualizzazione.

Un periodo di timeout è associato a ogni carattere digitato dall'utente. Se il periodo di timeout è trascorso prima che l'utente digita un altro carattere, la stringa di ricerca incrementale viene reimpostata.

Assicurarsi che il buffer sia abbastanza grande per contenere la stringa e il carattere NULL terminante. Se è troppo piccolo, verrà generato un errore di pagina non valido immediato.

Requisiti