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

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

Синтаксис

BOOL TreeView_SelectItem(
   HWND      hwnd,
   HTREEITEM hitem
);

Параметры

hwnd

Тип: HWND

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

hitem

Тип: HTREEITEM

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

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

Тип: BOOL

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

Замечания

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

Использование макроса TreeView_SelectItem эквивалентно отправке сообщения TVM_SELECTITEM с его флагом флагом значением TVGN_CARET.

Требования