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

Статья
08/11/2011

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

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

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

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

Пример закрепления из Visual Studio, где окно "Обзор класса" — DockPosition.Right, а окно "Список ошибок" — DockPosition.Bottom

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

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

Правила и соглашения по реализации
Необходимые элементы для IDockProvider
Исключения
Связанные разделы

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

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

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

Необходимые элементы для IDockProvider

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

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

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

Исключения

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

Тип исключения	Атрибут Condition
InvalidOperationException	SetDockPosition Когда элемент управления не может выполнить запрошенный стиль закрепления.

InvalidOperationException

SetDockPosition