macro ListView_GetISearchString (commctrl.h)

Obtiene la cadena de búsqueda incremental de un control de vista de lista. Puede usar esta macro o enviar el mensaje LVM_GETISEARCHSTRING explícitamente.

Sintaxis

BOOL ListView_GetISearchString(
   HWND  hwndLV,
   LPSTR lpsz
);

Parámetros

hwndLV

Tipo: HWND

Identificador del control list-view.

lpsz

Tipo: LPSTR de

Puntero a un búfer que recibe la cadena de búsqueda incremental. Para recuperar simplemente la longitud de la cadena, establezca lpsz en NULL.

Valor devuelto

Tipo: BOOL de

Devuelve el número de caracteres de la cadena de búsqueda incremental o cero si el control de vista de lista no está en modo de búsqueda incremental.

Observaciones

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 el usuario escribe. Si el período de tiempo de espera transcurrido 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. Si es demasiado pequeño, se producirá un error de página no válido inmediato.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	commctrl.h