макрос ListView_GetItemIndexRect (commctrl.h)

Статья
10/24/2024

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

Синтаксис

BOOL ListView_GetItemIndexRect(
  [in]      HWND        hwnd,
  [in]      LVITEMINDEX *plvii,
  [in]      LONG        iSubItem,
  [in]      LONG        code,
  [in, out] LPRECT      prc
);

Параметры

[in] hwnd

Тип: HWND

Дескриптор элемента управления "Представление списка".

[in] plvii

Тип: LVITEMINDEX*

Указатель на структуру LVITEMINDEX родительского элемента дочернего элемента. Вызывающий объект отвечает за выделение этой структуры и настройку его членов. plvii не должно быть NULL.

[in] iSubItem

Тип: LONG

Индекс дочернего объекта.

[in] code

Тип: LONG

Часть подitem представления списка, для которой требуется получить ограничивающий прямоугольник. Этот параметр должен быть одним из следующих значений.

Ценность	Значение
LVIR_BOUNDS	Возвращает ограничивающий прямоугольник всего подсети, включая значок и метку.
LVIR_ICON	Возвращает ограничивающий прямоугольник значка или небольшого значка дочернего элемента.
LVIR_LABEL	Возвращает ограничивающий прямоугольник дочернего текста.

[in, out] prc

Тип: LPRECT

Указатель на структуру RECT для получения координат. Вызывающий объект отвечает за выделение этой структуры. prc не должно быть NULL.

Возвращаемое значение

Тип: BOOL

Возвращает TRUE, если выполнено успешно или FALSE в противном случае.

Замечания

Если iSubItem равно нулю, этот макрос возвращает координаты прямоугольника элементу, на который указывает plvii. Значение LVIR_SELECTBOUNDS для кода параметра не поддерживается.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	commctrl.h

Поделиться через