Mensaje LB_SELECTSTRING

Definición

LB_SELECTSTRING
wParam = (WPARAM) indexStart;        // ítem anterior al de comenzar a buscar
lParam = (LPARAM)(LPCTSTR)lpszFind;  // dirección de la cadena a buscar

Una aplicación envía un mensaje LB_SELECTSTRING para buscar en un list box un ítem que empiece con los caracteres de una cadena especificada. Si se encuentra un ítem, éste es seleccionado.

Descripción

indexStart: valor de wParam. Especifica el índice, comenzando en cero, del ítem anterior al primer ítem por el que se empieza a buscar. Cuando la búsqueda llega al final del listbox, continúa desde el principio hasta que llegue al ítem cuyo índice es el especificado por el parámetro indexStart. Si indexStart es -1, se busca en todo el list box desde el principio.

Windows 95: el parámetro wParam está limitado a valores de 16 bits. Esto significa que los list box no pueden contener más de 32767 ítems. Aunque el número de ítems está limitado, el tamaño total en bytes de los ítems en un list box está sólo limitado por la memoria disponible.

lpszFind: valor de lParam. Apunta a una cadena terminada en cero que contiene el prefijo a buscar. La búsqueda es independiente del tipo, es decir que esta cadena puede contener cualquier combinación de letras mayúsculas o minúsculas.

Valor de retorno

Si la búsqueda tuvo éxito, el valor de retorno es el índice del ítem seleccionado. Si no lo tuvo, el valor de retorno es LB_ERR y la selección actual no cambia.

Observaciones

El contenido del list box es desplazado, si es necesario, para mostrar el ítem seleccionado.

No se debe usar este mensaje con un list box que tenga el estilo LBS_MULTIPLESEL.

Un ítem está seleccionado sólo si sus caracteres iniciales coinciden con la cadena especificada en el parámetro lpszFind.

Si se crea un list box con un estilo owner-drawn pero sin el estilo LBS_HASSTRINGS, este mensaje devuelve el índice del ítem cuyo valor largo (suministrado por el parámetro lParam del mensaje LB_ADDSTRING o LB_INSERTSTRING) coincida con el valor suministrado en el parámetro lParam de LB_SELECTSTRING.