winuser.h

Mensaje CB_FINDSTRINGEXACT

Definición

CB_FINDSTRING
wParam = (WPARAM) indexStart;        // ítem anterior al comienzo de la búsqueda
lParam = (LPARAM) (LPCSTR) lpszFind  // dirección de la cadena a buscar

Una aplicación envía un mensaje CB_FINDSTRINGEXACT para buscar en la lista de un combo box un ítem que coincida con la cadena lpszFind.

Descripción

indexStart: valor de wParam. Especifica el índice, comenzando en cero, del ítem anterior al primer ítem en 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 listbox desde el principio.

lpszFind: valor de lParam. Apunta a una cadena terminada en cero que contiene la cadena a buscar. Esta cadena puede contener un nombre de fichero completo, incluyendo la extensión. 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

El valor de retorno es el índice, empezando en cero, del ítem que coinzida. Si la búsqueda falla, el valor de retorno es CB_ERR.

Observaciones

Si se crea un combo box con un estilo owner-drawn pero sin el estilo CBS_HASSTRINGS, el resultado del mensaje CB_FINDSTRINGEXACT depende de si se usó el estilo CBS_SORT o no. Si se usó, el sistema envía mensajes WM_COMPAREITEM a la ventana propietaria del combo box para determinar qué ítem coincide con la cadena especificada. Si no se usó, CB_FINDSTRINGEXACT buscará en la lista un ítem que coincida con el valor del parámetro lpszFind.