messaggio di LB_SELECTSTRING
Cerca in una casella di riepilogo un elemento che inizia con i caratteri in una stringa specificata. Se viene trovato un elemento corrispondente, l'elemento viene selezionato.
Parametri
-
wParam
-
Indice in base zero dell'elemento che precede il primo elemento da cercare. Quando la ricerca raggiunge la parte inferiore della casella di riepilogo, continua dalla parte superiore della casella di riepilogo all'elemento specificato dal parametro wParam . Se wParam è -1, viene eseguita la ricerca dell'intera casella di riepilogo dall'inizio.
Windows 95/Windows 98/Windows Millennium Edition (Windows Me): il parametro wParam è limitato a valori a 16 bit. Ciò significa che le caselle di riepilogo non possono contenere più di 32.767 elementi. Anche se il numero di elementi è limitato, la dimensione totale in byte degli elementi in una casella di riepilogo è limitata solo dalla memoria disponibile.
-
lParam
-
Puntatore alla stringa con terminazione Null contenente il prefisso per il quale eseguire la ricerca. La ricerca è indipendente dal caso, quindi questa stringa può contenere qualsiasi combinazione di lettere maiuscole e minuscole.
Valore restituito
Se la ricerca ha esito positivo, il valore restituito è l'indice dell'elemento selezionato. Se la ricerca non riesce, il valore restituito viene LB_ERR e la selezione corrente non viene modificata.
Commenti
La casella di riepilogo viene scorrevole, se necessario, per visualizzare l'elemento selezionato.
Non utilizzare questo messaggio con una casella di riepilogo con gli stili di LBS_MULTIPLESEL o di LBS_EXTENDEDSEL .
Un elemento viene selezionato solo se i caratteri iniziali del punto iniziale corrispondono ai caratteri nella stringa specificata dal parametro lParam .
Se la casella di riepilogo ha lo stile disegnato dal proprietario ma non lo stile LBS_HASSTRINGS , l'azione eseguita da LB_SELECTSTRING dipende dal fatto che venga utilizzato lo stile LBS_SORT . Se si utilizza LBS_SORT , il sistema invia WM_COMPAREITEM messaggi al proprietario della casella di riepilogo per determinare quale elemento corrisponde alla stringa specificata. In caso contrario, LB_SELECTSTRING tenta di trovare un elemento con un valore lungo (fornito come parametro lParam del messaggio LB_ADDSTRING o LB_INSERTSTRING ) che corrisponde al parametro lParam .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista [solo app desktop] |
| Server minimo supportato |
Windows Server 2003 [solo app desktop] |
| Intestazione |
|
Vedi anche
-
Riferimento