Mensaje LVM_GETISEARCHSTRING

Definición

LVM_GETISEARCHSTRING
    lpsz=(LPARAM)(LPSTR)lParam

Obtiene la cadena de búsqueda incremental de un control list-view. Se puede enviar este mensaje explícitamente o bien usar la macro ListView_GetISearchString.

Descripción

lpsz

Un puntero a un buffer que recibirá la cadena de búsqueda incremental. Para recibir sólo la longitud de la cadena, asignar NULL a lpsz.

Valor de retorno

Devuelve el número de caracteres en la cadena de búsqueda incremental, sin incluir el carácter nulo terminador, o cero si el control list-view no está en modo de búsqueda incremental.

Observaciones

Aviso de seguridad: Usar este mensaje incorrectamente puede comprometer la seguridad del programa. Este mensaje no proporciona una forma de conocer el tamaño del buffer. Si se usa este mensaje, primero de debe enviar con el valor NULL en lParam, esto devuelve el número de caracteres, sin incluir el terminador nulo, que se requerirán. Usar el mensaje una segunda vez para recuperar la cadena.

La cadena de búsqueda incremental es una secuencia de caracteres que escribe el usuario mientras el list-view tiene el foco del teclado. Cada vez que el usuario introduce un carácter, el sistema lo añade a la cadena de búsqueda y a continuación busca un ítem que coincida. Si el sistema encuentra una coincidencia, selecciona el ítem y, si es necesario, lo desplaza dentro de la vista.

Un periodo de espera es asociado a cada carácter que introduce el usuario. Si ese periodo transcurre antes de que el usuario introduzca otro carácter, la cadena de búsqueda incremental se resetea.

Hay que asegurarse de que el buffer es lo suficientemente grande para contener la cadena. Si es demasiado pequeño, se producirá un fallo de página inválida de forma inmediata.