Compartir a través de


LB_SELECTSTRING mensaje

Busca en un cuadro de lista un elemento que comience por los caracteres de una cadena especificada. Si se encuentra un elemento coincidente, se selecciona el elemento.

Parámetros

wParam

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

Windows 95/Windows 98/Windows Millennium Edition (Windows Me): el parámetro wParam está limitado a valores de 16 bits. Esto significa que los cuadros de lista no pueden contener más de 32 767 elementos. Aunque el número de elementos está restringido, el tamaño total en bytes de los elementos de un cuadro de lista solo está limitado por la memoria disponible.

lParam

Puntero a la cadena terminada en null que contiene el prefijo para el que se va a buscar. La búsqueda es independiente de 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 la búsqueda se realiza correctamente, el valor devuelto es el índice del elemento seleccionado. Si la búsqueda no se realiza correctamente, el valor devuelto se LB_ERR y la selección actual no cambia.

Comentarios

El cuadro de lista se desplaza, si es necesario, para mostrar el elemento seleccionado.

No use este mensaje con un cuadro de lista que tenga los estilos LBS_MULTIPLESEL o LBS_EXTENDEDSEL .

Solo se selecciona un elemento si sus caracteres iniciales del punto inicial coinciden con los caracteres de la cadena especificada por el parámetro lParam .

Si el cuadro de lista tiene el estilo dibujado por el propietario, pero no el estilo LBS_HASSTRINGS , la acción realizada por LB_SELECTSTRING depende de si se usa el estilo de LBS_SORT . Si se usa LBS_SORT , el sistema envía mensajes WM_COMPAREITEM al propietario del cuadro de lista para determinar qué elemento coincide con la cadena especificada. De lo contrario, LB_SELECTSTRING intenta buscar un elemento que tenga un valor largo (proporcionado como el parámetro lParam del LB_ADDSTRING o LB_INSERTSTRING mensaje) que coincida con el 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

LB_ADDSTRING

LB_FINDSTRING

LB_INSERTSTRING