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	Winuser.h (include Windows.h)

Vedi anche

Riferimento

LB_ADDSTRING

LB_FINDSTRING

LB_INSERTSTRING