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
BOOL ListView_GetISearchString(
HWND hwndLV,
LPSTR lpsz
);
Parametri
hwndLV
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
Restituisce il numero di caratteri nella stringa di ricerca incrementale oppure zero se il controllo visualizzazione elenco non è in modalità di ricerca incrementale.
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, si verifica un errore immediato di pagina non valido.
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 |