macro ListView_GetISearchString (commctrl.h)

Ottiene la stringa di ricerca incrementale di un controllo visualizzazione elenco. È possibile utilizzare questa macro o inviare il messaggio di LVM_GETISEARCHSTRING in modo esplicito.

Sintassi

void ListView_GetISearchString(
   hwndLV,
   lpsz
);

Parametri

hwndLV

Tipo: HWND

Handle per il controllo visualizzazione elenco.

lpsz

Tipo: LPSTR

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

Valore restituito

nessuno

Osservazioni

La stringa di ricerca incrementale è la sequenza di caratteri digitata dall'utente mentre la visualizzazione elenco ha lo stato attivo per l'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 scade prima che l'utente digita un altro carattere, la stringa di ricerca incrementale viene reimpostata.

Assicurarsi che il buffer sia sufficientemente grande da contenere la stringa. Se è troppo piccolo, verrà generato un errore di pagina non valido immediato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h