Share via

Estructura LVHITTESTINFO (commctrl.h)

  • Artículo

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 el LVM_HITTEST y LVM_SUBITEMHITTEST mensajes 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

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

flags

Tipo: UINT

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 debe desplazar el contenido de un control de vista de lista. Se pueden combinar dos de estos valores. Por ejemplo, si la posición está por 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á por debajo del área 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 contenido de texto o icono 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 realiza una prueba de posicionamiento de 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 Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado commctrl.h