Шаблон элемента управления ExpandCollapse

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

Примеры элементов управления, реализующих этот шаблон элемента управления, см. в разделе Типы элементов управления и поддерживаемые ими шаблоны элементов управления.

В этом разделе содержатся следующие подразделы.

• Правила и соглашения реализации
• Обязательные элементы для IExpandCollapseProvider
• Связанные темы

Правила и соглашения реализации

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

• Агрегатные элементы управления, созданные на основе дочерних объектов, которые предоставляют пользовательскому интерфейсу функциональность развертывания и свертывания, должны поддерживать шаблон элемента управления ExpandCollapse , тогда как их дочерние элементы этого не делают. Например, элемент управления "Поле со списком" создается с сочетанием элементов управления "Список", "Кнопка" и "Изменить", но только родительское поле со списком должно поддерживать шаблон элемента управления ExpandCollapse .

  Примечание

  Исключением является элемент управления меню, который является агрегатом отдельных объектов пунктов меню. Объекты пунктов меню могут поддерживать шаблон элемента управления ExpandCollapse , но родительский элемент управления меню — нет. Аналогичное исключение применяется к элементам управления "Дерево" и "Элемент дерева".

   

• Если параметр IExpandCollapseProvider::ExpandCollapseState элемента управления имеет значение ExpandCollapseState_LeafNode, то все функции ExpandCollapse в настоящее время неактивны для элемента управления, и с помощью этого шаблона элемента управления можно получить только данные ExpandCollapseState. Если впоследствии добавляются какие-либо дочерние объекты, функция ExpandCollapseState изменяется и активируется функция ExpandCollapse .

• ExpandCollapseState — это видимость только непосредственных дочерних объектов; он не ссылается на видимость всех объектов-потомков.

• Функции IExpandCollapseProvider::Expand и Collapse зависят от элемента управления. Ниже представлены примеры такого поведения.

  • Личное меню Office может быть элементом меню с тремя состояниями ("Expanded", "Collapsed" и "PartiallyExpanded"), где элемент управления указывает состояние, которое будет применяться при вызове метода Expand или Collapse .
  • При вызове метода Expand для элемента дерева могут отображаться все потомки или только непосредственные дочерние элементы.
  • Если при вызове метода Expand или Collapse для элемента управления сохраняется состояние его потомков, должно быть отправлено событие изменения видимости, а не событие изменения состояния. Если родительский элемент управления не сохраняет состояние своих потомков при свернутом состоянии, элемент управления может уничтожить все потомки, которые больше не видны, и вызвать событие уничтожения; или может изменить expandCollapseState для каждого потомка и вызвать событие изменения видимости.

• Чтобы обеспечить навигацию, желательно, чтобы объект был в дереве Microsoft модель автоматизации пользовательского интерфейса (с соответствующим состоянием видимости) независимо от его родительских объектов ExpandCollapseState. Если потомки создаются по требованию, они могут отображаться в дереве модель автоматизации пользовательского интерфейса только после первого отображения или только в то время, когда они видны.

Обязательные элементы для IExpandCollapseProvider

Для реализации интерфейса IExpandCollapseProvider требуются следующие свойства, методы и события.

Обязательные члены	Тип члена	Примечания
ExpandCollapseState	Свойство	Нет
Разверните	Метод	Нет
Свернуть	Метод	Нет
IUIAutomationPropertyChangedEventHandler	Событие	Этот элемент управления не имеет связанных событий; используйте этот универсальный обработчик событий.

 

Связанные темы

Типы элементов управления и поддерживаемые ими шаблоны элементов управления

Общие сведения о шаблонах элементов управления модели автоматизации пользовательского интерфейса

Общие сведения о дереве модели автоматизации пользовательского интерфейса