Поделиться через


Реализация шаблона управления стыковкой автоматизации UI

Замечание

Эта документация предназначена для разработчиков .NET Framework, которые хотят использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в разделе API автоматизации Windows: автоматизация пользовательского интерфейса.

В этом разделе приводятся рекомендации и соглашения по реализации IDockProvider, включая сведения о свойствах. Ссылки на дополнительные материалы перечислены в конце раздела.

Шаблон DockPattern элемента управления используется для раскрытия свойств стыковки элемента управления в контейнере для стыковки. Контейнер док-станции — это элемент управления, позволяющий упорядочивать дочерние элементы по горизонтали и вертикали относительно друг друга. Примеры элементов управления, реализующих этот шаблон, см. в разделе Сопоставление шаблонов элементов управления для клиентов автоматизации пользовательского интерфейса.

Стыковочный контейнер с двумя стыкуемыми дочерними элементами. Пример стыковки из Visual Studio, где окно «Представление классов» — DockPosition.Right и окно «Список ошибок» — DockPosition.Bottom.

Рекомендации по реализации и соглашения

При реализации шаблона элемента управления Dock обратите внимание на следующие рекомендации и соглашения:

  • IDockProvider не предоставляет никаких свойств контейнера док-станции или каких-либо свойств элементов управления, которые закреплены рядом с текущим элементом управления в контейнере док-станции.

  • Элементы управления закреплены относительно друг друга на основе их текущего z-порядка; чем выше размещение z-порядка, тем дальше они помещаются с указанного края контейнера док-станции.

  • Если контейнер док-станции изменен, все закрепленные элементы управления в контейнере будут переналожены на тот же край, к которому они были первоначально закреплены. Закрепленные элементы управления также изменят размер, чтобы заполнить любое пространство в контейнере в соответствии с поведением закрепления их DockPosition. Например, если указано Top, левая и правая стороны элемента управления развернутся, чтобы заполнить любое доступное пространство. Если указано Fill, все четыре стороны элемента управления расширятся, чтобы заполнить любое доступное пространство.

  • В системе с несколькими мониторами элементы управления должны закрепиться слева или справа от текущего монитора. Если это невозможно, они должны закрепиться на левой стороне самого левого монитора или правой части самого правого монитора.

Требуемые элементы для IDockProvider

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

Обязательные участники Тип участника Примечания.
DockPosition Недвижимость Отсутствует
SetDockPosition Метод Отсутствует

Этот шаблон элемента управления не имеет связанных событий.

Исключения

Поставщики должны генерировать следующие исключения.

Тип исключения Состояние
InvalidOperationException SetDockPosition

— Если элемент управления не может выполнить запрошенный стиль стыковки.

См. также