CTreeCtrl::HitTest

Статья
02/20/2013

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

HTREEITEM HitTest(
   CPoint pt,
   UINT* pFlags = NULL
) const;
HTREEITEM HitTest(
   TVHITTESTINFO* pHitTestInfo 
) const;

Параметры

pt
Клиентские координаты точки в тест.
pFlags
Указатель целого числа, которое получает сведения о результатах проверки нажатия.Он может иметь одно или несколько значений, перечисленных в разделе членом флаги в разделе "Примечания".
pHitTestInfo
Адрес структуры TVHITTESTINFO, содержащая позицию для проверки нажатия и которая возвращает сведения о результатах проверки нажатия.

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

Дескриптор элемента представления в виде дерева, занимающий заданную точку или NULL если элемент не занимает точку.

Заметки

Если эта функция называется, параметр pt определяющий координаты точки в тест.Функция возвращает дескриптор элемента в указанной точке или NULL если элемент не занимает точку.Кроме того, параметр pFlags содержит значение, указывающее местоположение указанной точки.Доступны следующие значения:

Значение	Значение
TVHT_ABOVE	На клиентской области.
TVHT_BELOW	В клиентской области.
TVHT_NOWHERE	в клиентской области, но под последним элементом.
TVHT_ONITEM	В растровом изображении или метке, связанных с элементом.
TVHT_ONITEMBUTTON	На кнопке, связанной с элементом.
TVHT_ONITEMICON	В растровом изображении, связанном с элементом.
TVHT_ONITEMINDENT	В отступе, связанном с элементом.
TVHT_ONITEMLABEL	Метки (строку), связанного с элементом.
TVHT_ONITEMRIGHT	В области справа от элемента.
TVHT_ONITEMSTATEICON	На значке состояния для элемента представления в виде дерева, в определяемом пользователем состоянии.
TVHT_TOLEFT	Слева от клиентской области.
TVHT_TORIGHT	Справа от клиентской области.

Пример

// Select the item that is at the point myPoint.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);

if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
   m_TreeCtrl.SelectItem(hItem);
}