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

2024-10-24

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

Синтаксис

BOOL TreeView_Select(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

Параметры

hwnd

Тип: HWND

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

hitem

Тип: HTREEITEM

Обработка элемента. Если параметр hitemNULL, элемент управления не выбран.

code

Тип: UINT

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

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

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

Тип: BOOL

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

Замечания

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

Требования

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