winuser.h

Mensaje LB_FINDSTRINGEXACT

Definición

LB_FINDSTRINGEXACT  
wParam = (WPARAM) indexStart;       // ítem anterior del que comienza la búsqueda
lParam = (LPARAM)(LPCSTR)lpszFind;  // dirección de la cadena a buscar

Una aplicación envía un mensaje LB_FINDSTRINGEXACT para encontrar la primera cadena de un list box que coincide con la cadena especificada en el parámetro lpszFind.

Descripción

indexStart: valor de wParam. Especifica el índice, empezando en cero, del ítem anterior desde el que se empieza la búsqueda. Cuando la búsqueda llega al final del list box, continúa desde el principio del list box hasta el ítem especificado por el parámetro indexStart. Si indexStart es -1, se explora la lista completa 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 de un list box está sólo limitado por la memoria disponible.

lpszFind: valor de lParam. Apunta a la cadena terminada en cero a buscar. Esta cadena puede contener un nombre de fichero completo, incluyendo la extensión. La búsqueda es independiente del tipo, de modo que estga cadena puede contener cualquier combinación de letras en mayúscula y minúscula.

Valor de retorno

El valor de retorno es el índice de la cadena encontrada, o LB_ERR si la búsqueda fracasa.

Observaciones

Si una aplicación crea un list box con un estilo owner-dreawn pero sin el estilo LBS_HASSTRINGS, la acción tomada por LB_FINDSTRINGEXACT dependerá de si se usa el estilo LBS_SORT. Si se usa LBS_SORT, el sistema envía mensajes WM_COMPAREITEM a la ventana padre del list box para determinar qué ítem coincide con la cadena especificada. En otro caso, LB_FINDSTRINGEXACT intenta buscar coincidencia en el valor de 32 bits en lugar de hacerlo con el valor del parámetro lpszFind.