mensaje de LVM_GETISEARCHSTRING

Artículo
06/13/2023

Recupera la cadena de búsqueda incremental de un control de vista de lista. Puede enviar este mensaje explícitamente o mediante la macro ListView_GetISearchString .

Parámetros

wParam: Debe ser cero.
lParam: Puntero a un búfer que recibe la cadena de búsqueda incremental. Para recuperar la longitud de la cadena, establezca lParam en NULL.

Valor devuelto

Devuelve el número de caracteres de la cadena de búsqueda incremental, sin incluir el carácter NULL de terminación, o cero si el control de vista de lista no está en modo de búsqueda incremental.

Observaciones

Advertencia de seguridad: Usar este mensaje incorrectamente podría poner en peligro la seguridad de su programa. Este mensaje no proporciona una manera de conocer el tamaño del búfer. Si usa este mensaje, llame primero al mensaje pasando NULL en lParam, devuelve el número de caracteres, excepto NULL que son necesarios. A continuación, llame al mensaje una segunda vez para recuperar la cadena. Debe revisar las consideraciones de seguridad: controles de Microsoft Windows antes de continuar.

La cadena de búsqueda incremental es la secuencia de caracteres que el usuario escribe mientras la vista de lista tiene el foco de entrada. Cada vez que el usuario escribe un carácter, el sistema anexa el carácter a la cadena de búsqueda y, a continuación, busca un elemento coincidente. Si el sistema encuentra una coincidencia, selecciona el elemento y, si es necesario, lo desplaza a la vista.

Un período de tiempo de espera se asocia a cada carácter que escribe el usuario. Si el período de tiempo de espera transcurre antes de que el usuario escriba otro carácter, se restablece la cadena de búsqueda incremental.

Asegúrese de que el búfer es lo suficientemente grande como para contener la cadena y el carácter NULL de terminación. Si es demasiado pequeño, se producirá un error de página no válido inmediato.

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	Commctrl.h
Nombres Unicode y ANSI	LVM_GETISEARCHSTRINGW (Unicode) y LVM_GETISEARCHSTRINGA (ANSI)