Estructura LVHITTESTINFO

Definición

typedef struct tagLVHITTESTINFO {
  POINT pt;
  UINT  flags;
  int   iItem;
  int   iSubItem;
  int   iGroup;
} LVHITTESTINFO, *PLVHITTESTINFO;

Contiene información sobre el punto de prueba. Esta estructura ha sido ampliada para incluir pruebas de puntos de subítems. Se usa en asociación con los mensajes LVM_HITTEST yLVM_SUBITEMHITTEST y sus correspondientes macros. Esta estructura sustituye a la estructura LVHITTESTINFO.

Descripción

pt

La posición del punto de prueba, en coordenadas de cliente.

flags

la variable que recibe información sobre el resultado de un punto de prueba. Este miembro puede ser uno o más de los siguientes valores:

Se puede usar LVHT_ABOVE, LVHT_BELOW, LVHT_TOLEFT y LVHT_TORIGHT para determinar si el contenido de un control list-view desplaza su contenido (scroll). Dos de esos valores pueden ser combinados. Por ejemplo, si la posición está sobre y a la izquierda del área de cliente, se pueden usar los valores LVHT_ABOVE y LVHT_TOLEFT.

Se puede usar LVHT_ONITEM para determinar si la posición especificada está sobre un ítem del list-view. Este valor es una combinación OR de LVHT_ONITEMICON, LVHT_ONITEMLABEL y LVHT_ONITEMSTATEICON.

Valor	Significado
LVHT_ABOVE	La posición está por encima del área de cliente del control.
LVHT_BELOW	La posición está por debajo del área de cliente del control.
LVHT_NOWHERE	La posición está dentro de la ventana cliente del control list-view, pero no sobre un ítem.
LVHT_ONITEMICON	La posición está sobre el icono de un ítem del list-view.
LVHT_ONITEMLABEL	La posición está sobre el texto de un ítem del list-view.
LVHT_ONITEMSTATEICON	La posición está sobre la imagen de estado de un ítem del list-view.
LVHT_TOLEFT	La posición está a la izquierda del área de cliente del control list-view.
LVHT_TORIGHT	La posición está a la derecha del área de cliente del control list-view.
LVHT_EX_GROUP_HEADER	Windows Vista. El punto está dentro de la cabecera de grupo.
LVHT_EX_GROUP_FOOTER	Windows Vista. El punto está dentro del pie de grupo.
LVHT_EX_GROUP_COLLAPSE	Windows Vista. El punto está dentro del botón colapsar/expandir del grupo.
LVHT_EX_GROUP_BACKGROUND	Windows Vista. El punto está dentrol del a´rea del grupo donde son mostrados los ítems.
LVHT_EX_GROUP_STATEICON	Windows Vista. El punto está dentro del icono de estado del grupo.
LVHT_EX_GROUP_SUBSETLINK	Windows Vista. El punto está dentro del enlace de subconjunto del grupo.
LVHT_EX_GROUP	Windows Vista. LVHT_EX_GROUP_BACKGROUND | LVHT_EX_GROUP_COLLAPSE | LVHT_EX_GROUP_FOOTER | LVHT_EX_GROUP_HEADER | LVHT_EX_GROUP_STATEICON | LVHT_EX_GROUP_SUBSETLINK.
LVHT_EX_ONCONTENTS	Windows Vista. El punto está dentro del icono o del texto de contenido y no en el fondo.
LVHT_EX_FOOTER	Windows Vista. El punto está dentro del pie del control list-view.

iitem

Recibe el índice del ítem que coincida. O si el punto de prueba es un subítem, este valor representa el ítem padre del subítem.

iSubItem

Versión 4.70. Recibe el índice del subítem que coincida. Cuando el punto de prueba sea un ítem, este miembro será cero.

iGroup

Windows Vista. Índice del grupo del ítem que coincida (solo lectura). Válido solo para dato del propietario. Si el punto está dentro de un ítem que está mostrado en varios grupos, entonces iGroup especificará el índice del ítem.