Share via

Функция LBItemFromPt (commctrl.h)

  • Статья

Извлекает индекс элемента в указанной точке в списке.

Синтаксис

int LBItemFromPt(
  HWND  hLB,
  POINT pt,
  BOOL  bAutoScroll
);

Параметры

hLB

Тип: HWND

Дескриптор для проверка списка.

pt

Тип: POINT

Структура POINT, содержащая координаты экрана для проверка.

bAutoScroll

Тип: BOOL

Флаг прокрутки. Если этот параметр имеет значение TRUE и точка находится непосредственно над списком или под ним, функция прокручивает список на одну строку и возвращает значение -1. В противном случае функция не прокрутит список.

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

Тип: int

Возвращает идентификатор элемента, если точка находится над элементом списка, или значение -1 в противном случае.

Комментарии

Функция LBItemFromPt прокручивает список только в том случае, если прошло минимальное время с момента последнего выполнения. Синхронизация предотвращает слишком быструю прокрутку списка, если функция вызывается многократно в быстром последовательном режиме, например при обработке DL_DRAGGING кодов уведомлений или WM_MOUSEMOVE сообщений.

Если указанная точка находится за пределами клиентской области списка, а параметр bAutoScroll имеет значение TRUE, функция прокручивает список, а не возвращает идентификатор элемента.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header commctrl.h
Библиотека Comctl32.lib
DLL Comctl32.dll