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

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

  • Статья

Примечание.

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

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

Шаблон элемента управления DockPattern используется для предоставления свойств закрепления элемента управления в контейнере закрепления. Контейнер закрепления — это элемент управления, который позволяет упорядочить дочерние элементы по горизонтали и по вертикали друг относительно друга. Примеры элементов управления, реализующие данный шаблон элемента управления, см. в разделе Control Pattern Mapping for UI Automation Clients.

Docking container with two docked children. Пример закрепления из Visual Studio, где окно "Представление классов" — DockPosition.Right и окно "Список ошибок" — DockPosition.Bottom

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

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

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

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

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

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

Обязательные члены для IDockProvider

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

Обязательные члены Тип члена Примечания.
DockPosition Свойство нет
SetDockPosition Способ нет

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

Исключения

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

Тип исключения Condition
InvalidOperationException SetDockPosition

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

См. также