Compartir vía


mensaje de CB_SELECTSTRING

Busca en la lista de un cuadro combinado un elemento que comienza por los caracteres de una cadena especificada. Si se encuentra un elemento coincidente, se selecciona y se copia en el control de edición.

Parámetros

wParam

Índice de base cero del elemento que precede al primer elemento que se va a buscar. Cuando la búsqueda llega a la parte inferior de la lista, continúa desde la parte superior de la lista hasta el elemento especificado por el parámetro wParam . Si wParam es -1, se busca en toda la lista desde el principio.

lParam

Puntero a la cadena terminada en null que contiene los caracteres para los que se va a buscar. La búsqueda no distingue entre mayúsculas y minúsculas, por lo que esta cadena puede contener cualquier combinación de letras mayúsculas y minúsculas.

Valor devuelto

Si se encuentra la cadena, el valor devuelto es el índice del elemento seleccionado. Si la búsqueda no se realiza correctamente, el valor devuelto se CB_ERR y la selección actual no cambia.

Observaciones

Solo se selecciona una cadena si los caracteres del punto inicial coinciden con los caracteres de la cadena de prefijo.

Si crea el cuadro combinado con un estilo dibujado por el propietario pero sin el estilo CBS_HASSTRINGS , lo que hace el CB_SELECTSTRING mensaje depende de si usa el estilo CBS_SORT . Si se usa el estilo de CBS_SORT , el sistema envía mensajes WM_COMPAREITEM al propietario del cuadro combinado para determinar qué elemento coincide con la cadena especificada. Si no usa el estilo CBS_SORT , CB_SELECTSTRING intenta hacer coincidir el valor DWORD con el valor del parámetro lParam .

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Winuser.h (incluye Windows.h)

Consulte también

Referencia

CB_FINDSTRING

CB_FINDSTRINGEXACT

CB_SETCURSEL

WM_COMPAREITEM