Структура LVHITTESTINFO (commctrl.h)

  • Статья

Содержит сведения о проверке нажатия. Эта структура была расширена для выполнения подэлементного тестирования попадания. Он используется в связи с LVM_HITTEST и LVM_SUBITEMHITTEST сообщениями и связанными с ними макросами. Эта структура заменяет структуру LVHITTESTINFO .

Синтаксис

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

Члены

pt

Тип: POINT

Позиция для проверки нажатия в координатах клиента.

flags

Тип: UINT

Переменная, получающая сведения о результатах проверки нажатия. Этот элемент может иметь одно или несколько из следующих значений:

Вы можете использовать LVHT_ABOVE, LVHT_BELOW, LVHT_TOLEFT и LVHT_TORIGHT, чтобы определить, следует ли прокручивать содержимое элемента управления представлением списка. Два из этих значений могут быть объединены. Например, если позиция находится выше и слева от клиентской области, можно использовать как LVHT_ABOVE, так и LVHT_TOLEFT. 

Вы можете проверить LVHT_ONITEM, чтобы определить, находится ли указанная позиция над элементом представления списка. Это значение представляет собой побитовую операцию ИЛИ для LVHT_ONITEMICON, LVHT_ONITEMLABEL и LVHT_ONITEMSTATEICON.

Значение Значение
LVHT_ABOVE
 Положение находится над клиентской областью элемента управления.
LVHT_BELOW
 Положение находится под клиентской областью элемента управления.
LVHT_NOWHERE
 Позиция находится внутри клиентского окна элемента управления представлением списка, но не над элементом списка.
LVHT_ONITEMICON
 Позиция находится над значком элемента представления списка.
LVHT_ONITEMLABEL
 Позиция находится над текстом элемента представления списка.
LVHT_ONITEMSTATEICON
 Позиция находится над изображением состояния элемента представления списка.
LVHT_TOLEFT
 Позиция находится слева от клиентской области элемента управления представлением списка.
LVHT_TORIGHT
 Позиция находится справа от клиентской области элемента управления представлением списка.
LVHT_EX_GROUP_HEADER
 Windows Vista. Точка находится в заголовке группы.
LVHT_EX_GROUP_FOOTER
 Windows Vista. Точка находится в нижнем колонтитуле группы.
LVHT_EX_GROUP_COLLAPSE
 Windows Vista. Точка находится в пределах кнопки свернуть/развернуть группу.
LVHT_EX_GROUP_BACKGROUND
 Windows Vista. Точка находится в области группы, в которой отображаются элементы.
LVHT_EX_GROUP_STATEICON
 Windows Vista. Точка находится в значке состояния группы.
LVHT_EX_GROUP_SUBSETLINK
 Windows Vista. Точка находится в пределах подмножества связи группы.
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. Точка находится внутри значка или текстового содержимого элемента, а не на фоне.
LVHT_EX_FOOTER
 Windows Vista. Точка находится в нижнем колонтитуле элемента управления представлением списка.

iItem

Тип: int

Получает индекс соответствующего элемента. Или при проверке нажатия подэлемента это значение представляет родительский элемент подэлемента.

iSubItem

Тип: int

Версия 4.70. Получает индекс соответствующего подэлемента. При проверке попадания элемента этот элемент будет равен нулю.

iGroup

Тип: int

Windows Vista. Группировать индекс попадания элемента (только для чтения). Допустимо только для данных владельца. Если точка находится в элементе, который отображается в нескольких группах, iGroup укажет индекс группы элемента.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть commctrl.h