Share via

TVM_EXPAND сообщение

  • Статья

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

Параметры

wParam

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

Значение Значение
TVE_COLLAPSE
 Свертывание списка.
TVE_COLLAPSERESET
 Свертывание списка и удаление дочерних элементов. Флаг состояния TVIS_EXPANDEDONCE сбрасывается. Этот флаг должен использоваться с флагом TVE_COLLAPSE.
TVE_EXPAND
 Разворачивает список.
TVE_EXPANDPARTIAL
 Версия 4.70. Частично расширяет список. В этом состоянии отображаются дочерние элементы, а также отображается знак "плюс" родительского элемента (+), указывающий, что его можно развернуть. Этот флаг должен использоваться в сочетании с флагом TVE_EXPAND.
TVE_TOGGLE
 Сворачивает список, если он развернут, или разворачивает его, если он свернут.

lParam

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

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

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

Комментарии

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

При первом развертывании элемента 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 [только классические приложения]
Заголовок
Commctrl.h