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

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

Синтаксис

void TreeView_Expand(
   hwnd,
   hitem,
   code
);

Параметры

hwnd

Тип: HWND

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

hitem

Тип: HTREEITEM

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

code

Тип: UINT

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

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

None

Remarks

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

При первом развертывании элемента с помощью сообщения 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 .

Требования

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