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 |
|
Consulte también
-
Referencia