commctrl.h

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.

ValorSignificado
LVHT_ABOVELa posición está por encima del área de cliente del control.
LVHT_BELOWLa posición está por debajo del área de cliente del control.
LVHT_NOWHERELa posición está dentro de la ventana cliente del control list-view, pero no sobre un ítem.
LVHT_ONITEMICONLa posición está sobre el icono de un ítem del list-view.
LVHT_ONITEMLABELLa posición está sobre el texto de un ítem del list-view.
LVHT_ONITEMSTATEICONLa posición está sobre la imagen de estado de un ítem del list-view.
LVHT_TOLEFTLa posición está a la izquierda del área de cliente del control list-view.
LVHT_TORIGHTLa posición está a la derecha del área de cliente del control list-view.
LVHT_EX_GROUP_HEADERWindows Vista. El punto está dentro de la cabecera de grupo.
LVHT_EX_GROUP_FOOTERWindows Vista. El punto está dentro del pie de grupo.
LVHT_EX_GROUP_COLLAPSEWindows Vista. El punto está dentro del botón colapsar/expandir del grupo.
LVHT_EX_GROUP_BACKGROUNDWindows Vista. El punto está dentrol del a´rea del grupo donde son mostrados los ítems.
LVHT_EX_GROUP_STATEICONWindows Vista. El punto está dentro del icono de estado del grupo.
LVHT_EX_GROUP_SUBSETLINKWindows Vista. El punto está dentro del enlace de subconjunto del grupo.
LVHT_EX_GROUPWindows 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_ONCONTENTSWindows Vista. El punto está dentro del icono o del texto de contenido y no en el fondo.
LVHT_EX_FOOTERWindows 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.