Compartir a través de

Estructura LVFINDINFOA (commctrl.h)

  • Artículo

Contiene información que se usa al buscar un elemento de vista de lista. Esta estructura es idéntica a LV_FINDINFO pero se ha cambiado el nombre para ajustarse a las convenciones de nomenclatura estándar.

Sintaxis

typedef struct tagLVFINDINFOA {
  UINT   flags;
  LPCSTR psz;
  LPARAM lParam;
  POINT  pt;
  UINT   vkDirection;
} LVFINDINFOA, *LPFINDINFOA;

Miembros

flags

Tipo: UINT de

Tipo de búsqueda que se va a realizar. Este miembro se puede establecer en uno o varios de los siguientes valores:

Valor Significado
LVFI_PARAM
 Busca una coincidencia entre el miembro lParam de esta estructura y el miembro lParam de la estructura LVIT EM de un elemento.
LVFI_PARTIAL
 Comprueba si el texto del elemento comienza con la cadena a la que apunta el miembro psz. Este valor implica el uso de LVFI_STRING.
LVFI_STRING
 Busca en función del texto del elemento. A menos que se especifiquen valores adicionales, el texto del elemento coincidente debe coincidir exactamente con la cadena a la que apunta el miembro psz. Sin embargo, la búsqueda no distingue mayúsculas de minúsculas.
LVFI_SUBSTRING
 Windows Vista y versiones posteriores. Equivalente a LVFI_PARTIAL.
LVFI_WRAP
 Continúa la búsqueda al principio si no se encuentra ninguna coincidencia. Si esta marca se usa por sí misma, se supone que se desea una búsqueda de cadenas.
LVFI_NEARESTXY
 Busca el elemento más cercano a la posición especificada en el miembro pt , en la dirección especificada por el miembro vkDirection. Esta marca solo es compatible con los modos de icono grande y pequeño. Si se especifica LVFI_NEARESTXY, se omiten todas las demás marcas.

psz

Tipo: LPCTSTR de

Dirección de una cadena terminada en NULL que se va a comparar con el texto del elemento. Solo es válido si LVFI_STRING o LVFI_PARTIAL está establecido en los marcas miembro.

lParam

Tipo: LPARAM de

Valor que se va a comparar con el lParam miembro de la estructura LVITEM de un elemento de vista de lista. Solo es válido si LVFI_PARAM se establece en las marcas de miembro.

pt

Tipo: POINT de

estructura point con la posición de búsqueda inicial. Solo es válido si LVFI_NEARESTXY se establece en las marcas de miembro.

vkDirection

Tipo: UINT de

Código de clave virtual que especifica la dirección que se va a buscar. Se admiten los siguientes códigos:

  • VK_LEFT
  • VK_RIGHT
  • VK_UP
  • VK_DOWN
  • VK_HOME
  • VK_END
  • VK_PRIOR
  • VK_NEXT
Este miembro solo es válido si LVFI_NEARESTXY está establecido en las marcas de miembro.

Observaciones

Nota

El encabezado commctrl.h define LVFINDINFO como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

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