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

  • Статья

Выбирает указанный элемент в виде дерева, прокручивает его в представление или перерисовывает элемент в стиле, используемом для указания целевого объекта операции перетаскивания. Вы можете использовать этот макрос, макрос TreeView_SelectItem, TreeView_SelectSetFirstVisible или TreeView_SelectDropTarget , а также отправить сообщение TVM_SELECTITEM явным образом.

Синтаксис

void TreeView_Select(
   hwnd,
   hitem,
   code
);

Параметры

hwnd

Тип: HWND

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

hitem

Тип: HTREEITEM

Дескриптор элемента. Если параметр hitem имеет значение NULL, элемент управления не имеет выбранного элемента.

code

Тип: UINT

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

Значение Значение
TVGN_CARET
 Задает для выбора заданный элемент. Родительское окно элемента управления получает коды уведомлений TVN_SELCHANGING и TVN_SELCHANGED .
TVGN_DROPHILITE
 Перерисовывает заданный элемент в стиле, используемом для указания целевого объекта операции перетаскивания.
TVGN_FIRSTVISIBLE
 Гарантирует, что указанный элемент отображается и, если возможно, отображает его в верхней части окна элемента управления. Элементы управления в виде дерева отображают столько элементов, сколько поместится в окне. Если указанный элемент находится в нижней части иерархии элементов элемента управления, он может не стать первым видимым элементом в зависимости от того, сколько элементов помещается в окне.

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

None

Remarks

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

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header commctrl.h