macro ListBox_SelectItemData (windowsx.h)

Cerca in una casella di riepilogo un elemento con i dati dell'elemento specificati. 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_SelectItemData(
   HWND   hwndCtl,
   int    indexStart,
   LPARAM data
);

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.

data

Tipo: LPARAM

Dati dell'elemento 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