Estructura LVFINDINFOA (commctrl.h)

  • Artículo

Contiene información utilizada 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

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

Valor Significado
LVFI_PARAM
 Busca una coincidencia entre el miembro lParam de esta estructura y el miembro lParam de la estructura LVITEM 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

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 el miembro flags .

lParam

Tipo: LPARAM

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

pt

Tipo: POINT

Estructura POINT con la posición de búsqueda inicial. Solo es válido si LVFI_NEARESTXY está establecido en el miembro flags .

vkDirection

Tipo: UINT

Código de clave virtual que especifica la dirección de búsqueda. 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 el miembro flags .

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado commctrl.h