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

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

Синтаксис

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

Параметры

hwnd

Тип: HWND

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

hitem

Тип: HTREEITEM

Обработка родительского элемента, который будет развернут или свернут.

code

Тип: UINT

Флаг действия. Список возможных значений см. в описании параметра wParam в TVM_EXPAND.

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

Тип: BOOL

Возвращает ненулевое значение, если операция была успешной или нулевой.

Замечания

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

При первом развертывании элемента в сообщении TVM_EXPAND действие создает коды уведомлений TVN_ITEMEXPANDING и TVN_ITEMEXPANDED и задает флаг TVIS_EXPANDEDONCE состояния элемента. Пока этот флаг состояния по-прежнему установлен, последующие сообщения TVM_EXPAND не создают TVN_ITEMEXPANDING или TVN_ITEMEXPANDED уведомления. Чтобы сбросить флаг состояния TVIS_EXPANDEDONCE, необходимо отправить сообщение TVM_EXPAND с набором флагов TVE_COLLAPSE и TVE_COLLAPSERESET. Попытка явно задать TVIS_EXPANDEDONCE приведет к непредсказуемому поведению.

Операция развертывания может завершиться ошибкой, если владелец элемента управления treeview запрещает операцию в ответ на уведомление TVN_ITEMEXPANDING.

Требования