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

Прокручивает элемент управления представления дерева по вертикали, чтобы убедиться, что указанный элемент отображается. Если это возможно, указанный элемент становится первым видимым элементом в верхней части окна элемента управления. Этот макрос или макрос TreeView_Select можно использовать или отправить сообщение TVM_SELECTITEM явным образом.

Синтаксис

BOOL TreeView_SelectSetFirstVisible(
   HWND      hwnd,
   HTREEITEM hitem
);

Параметры

hwnd

Тип: HWND

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

hitem

Тип: HTREEITEM

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

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

Тип: BOOL

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

Замечания

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

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

Использование макроса TreeView_SelectSetFirstVisible эквивалентно отправке сообщения TVM_SELECTITEM со своим флагом флагом, заданным в значение TVGN_FIRSTVISIBLE.

Требования