Estructura LVHITTESTINFO (commctrl.h)

Contiene información sobre una prueba de posicionamiento. Esta estructura se ha ampliado para dar cabida a las pruebas de posicionamiento del subelemento. Se usa en asociación con los mensajes LVM_HITTEST y LVM_SUBITEMHITTEST y sus macros relacionadas. Esta estructura sustituye a la estructura LVHITTESTINFO.

Sintaxis

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

Miembros

pt

Tipo:POINT de

Posición de la prueba de posicionamiento, en coordenadas de cliente.

flags

Tipo:UINT de

Variable que recibe información sobre los resultados de una prueba de posicionamiento. Este miembro puede ser uno o varios de los siguientes valores:

Puede usar LVHT_ABOVE, LVHT_BELOW, LVHT_TOLEFT y LVHT_TORIGHT para determinar si se desplaza el contenido de un control de vista de lista. Se pueden combinar dos de estos valores. Por ejemplo, si la posición está encima y a la izquierda del área de cliente, puede usar tanto LVHT_ABOVE como LVHT_TOLEFT. 

Puede probar LVHT_ONITEM para determinar si una posición especificada está sobre un elemento de vista de lista. Este valor es una operación OR bit a bit en LVHT_ONITEMICON, LVHT_ONITEMLABEL y LVHT_ONITEMSTATEICON.

Valor	Significado
LVHT_ABOVE	La posición está por encima del área cliente del control.
LVHT_BELOW	La posición está debajo del área de cliente del control.
LVHT_NOWHERE	La posición está dentro de la ventana de cliente del control de vista de lista, pero no se encuentra sobre un elemento de lista.
LVHT_ONITEMICON	La posición se encuentra sobre el icono de un elemento de vista de lista.
LVHT_ONITEMLABEL	La posición se encuentra sobre el texto de un elemento de vista de lista.
LVHT_ONITEMSTATEICON	La posición se encuentra sobre la imagen de estado de un elemento de vista de lista.
LVHT_TOLEFT	La posición está a la izquierda del área cliente del control de vista de lista.
LVHT_TORIGHT	La posición está a la derecha del área cliente del control de vista de lista.
LVHT_EX_GROUP_HEADER	Windows Vista. El punto está dentro del encabezado de grupo.
LVHT_EX_GROUP_FOOTER	Windows Vista. El punto está dentro del pie de página del grupo.
LVHT_EX_GROUP_COLLAPSE	Windows Vista. El punto está dentro del botón contraer o expandir del grupo.
LVHT_EX_GROUP_BACKGROUND	Windows Vista. El punto está dentro del área del grupo donde se muestran los elementos.
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 vínculo 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 contenido de texto del elemento y no en el fondo.
LVHT_EX_FOOTER	Windows Vista. El punto está dentro del pie de página del control de vista de lista.

iItem

Tipo: int

Recibe el índice del elemento coincidente. O bien, si se prueba un subelemento, este valor representa el elemento primario del subelemento.

iSubItem

Tipo: int

versión 4.70. Recibe el índice del subelemento coincidente. Cuando se realiza la prueba de posicionamiento de un elemento, este miembro será cero.

iGroup

Tipo: int

Windows Vista. Índice de grupo de la acierto del elemento (solo lectura). Válido solo para los datos de propietario. Si el punto está dentro de un elemento que se muestra en varios grupos, iGroup especificará el índice de grupo del elemento.

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