winuser.h

Mensaje CB_FINDSTRING

Definición

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

Una aplicación envía un mensaje CB_FINDSTRING para buscar en la lista de un combo box un ítem que empiece con los caracteres de la cadena especificada.

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 list box, 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.

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

El valor de retorno es el índice, empezando en cero, del ítem encontrado. Si no se encontró la cadena, 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_FINDSTRING 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_FINDSTRING buscará en la lista un ítem que coincida con el valor del parámetro lpszFind.