macro ListBox_SelectString (windowsx.h)

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. È possibile utilizzare questa macro o inviare il messaggio di LB_SELECTSTRING in modo esplicito.

Sintassi

int ListBox_SelectString(
   HWND    hwndCtl,
   int     indexStart,
   LPCTSTR lpszFind
);

Parametri

hwndCtl

Tipo: HWND

Handle per il controllo.

indexStart

Tipo: int

Indice in base zero dell'elemento prima della ricerca del primo elemento. Quando la ricerca raggiunge la parte inferiore della casella di riepilogo, continua la ricerca dalla parte superiore della casella di riepilogo all'elemento specificato dal parametro indexStart. Se indexStart è -1, viene eseguita la ricerca dell'intera casella di riepilogo dall'inizio.

lpszFind

Tipo: LPCTSTR

Stringa da trovare.

Valore restituito

Tipo: int

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.

Osservazioni

Per altre informazioni, vedere LB_SELECTSTRING.

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 windowsx.h