commctrl.h

Estructura LVFINDINFO

Definición

typedef struct tagLVFINDINFO {
  UINT   flags;
  LPCSTR psz;
  LPARAM lParam;
  POINT  pt;
  UINT   vkDirection;
} LVFINDINFO, *PLVFINDINFO;

Contiene información usada cuando se busca un ítem en un list-view. Esta estructura es idéntica a LV_FINDINFO, pero ha sido renombrada para ceñirse a las convenciones de nombres estándar.

Descripción

flags

Tipo de búsqueda a realizar. Este miembro puede ser asignado a uno o más de los siguientes valores:

ValorSignificado
LVFI_PARAMBusca una coincidencia entre el miembro lParam de esta estructura y el miembro lParam en la estructura LVITEM del ítem.
LVFI_PARTIALVerifica si el texto del ítem empieza con la cadena apuntada por el miembro psz. Este valor implica usar también LVFI_STRING.
LVFI_STRINGBúsqueda basada en el texto del ítem. Si no se indican valores adicionales, el texto del ítem debe coincidir exactamente con la cadena apuntada por el miembro psz. Sin embargo, la búsqueda distingue mayúsculas y minúsculas.
LVFI_SUBSTRINGWindows Vista y posteriores. Equivalente a LVFI_PARTIAL.
LVFI_WRAPContinua la búsqueda desde el principio si no se encuentra coincidencia. Si se usa esta bandera se asume que se quiere una búsqueda de cadena.
LVFI_NEARESTXYEncuentra el ítem más cercano a la posición especificada por el miembro pt, en la dirección especificada por el miembro vkDirection. Esta bandera solo está soportada para vistas de iconos grandes e iconos pequeños. Si se especifica LVFI_NEARESTXY, el resto de las banderas son ignorados.
psz
Dirección de una cadena terminada en cero a comparar con el texto del ítem. Es válido solo si las banderas LVFI_STRING o LVFI_PARTIAL están asignadas en el miembro flags.
lParam
Valor a comparar con el miembro lParam de la estructura LVITEM del ítem de un control list-view. Solo es válido solo si el valor LVFI_PARAM está asignado en el miembro flags.
pt
Estructura POINT con la posición inicial de búsqueda. Solo es válida si la bandera LVFI_NEARESTXY está asignada en el miembro flags.
vkDirection

Código de tecla virtual que especifica la dirección de búsqueda. Están soportados los siguientes códigos:

  • VK_LEFT
  • VK_RIGHT
  • VK_UP
  • VK_DOWN
  • VK_HOME
  • VK_END
  • VK_PRIOR
  • VK_NEXT

Este miembro es válido solo si la bandera LVFI_NEARESTXY está asignada en el miembro flags.

Observaciones

Nota: El fichero de cabecera commctrl.h define LVFINDINFO como un alias que selecciona automáticamente la versión ANSI o UNICODE de esta estructura basándose en la definición de la constante del preprocesador UNICODE. Mezclar el uso de alias de codificación neutral con código que no use esa codificación puede producir desajustes que resulten en errores de compilación o de ejecución.