Реализация шаблона элемента управления модели автоматизации пользовательского интерфейса Dock
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе приводятся рекомендации и соглашения для реализации IDockProvider, включая сведения о свойствах. Ссылки на дополнительные материалы перечислены в конце раздела.
Шаблон элемента управления DockPattern используется для предоставления свойств закрепления элемента управления в контейнере закрепления. Контейнер закрепления — это элемент управления, который позволяет упорядочить дочерние элементы по горизонтали и по вертикали друг относительно друга. Примеры элементов управления, реализующие данный шаблон элемента управления, см. в разделе Control Pattern Mapping for UI Automation Clients.
Пример закрепления из Visual Studio, где окно "Представление классов" — DockPosition.Right и окно "Список ошибок" — DockPosition.Bottom
Правила и соглашения реализации
При реализации шаблона элемента управления Dock обратите внимание на следующие правила и соглашения.
IDockProvider не предоставляет какие-либо свойства контейнера закрепления или какие-либо свойства элементов управления, закрепленных рядом с текущим элементом управления в контейнере закрепления.
Элементы управления закрепляются относительно друг друга в зависимости от их текущего z-порядка; чем больше z-порядок расположения, тем дальше они размещены от заданного края контейнера закрепления.
При изменении размеров контейнера закрепления все закрепленные элементы управления в контейнере будут перенесены с выравниванием по тому же краю, к которому они были первоначально прикреплены. Размеры закрепленных элементов управления также будут изменены для заполнения пробелов в контейнере согласно поведению закрепления их DockPosition. Например, если указано Top , левая и правая стороны элемента управления будут расширены для заполнения всего доступного пространства. Если указано Fill , все четыре стороны элемента управления будут расширены для заполнения всего доступного пространства.
На системах с несколькими мониторами элементы управления должны закрепляться с левой или правой стороны текущего монитора. Если это невозможно, они должны закрепляться с левой стороны крайнего левого монитора или с правой стороны крайнего правого монитора.
Обязательные члены для IDockProvider
Следующие свойства и методы обязательны для реализации интерфейса IDockProvider.
| Обязательные члены | Тип члена | Примечания. |
|---|---|---|
| DockPosition | Свойство | нет |
| SetDockPosition | Способ | нет |
Этот шаблон элемента управления не имеет связанных событий.
Исключения
Поставщики должны вызывать следующие исключения.
| Тип исключения | Condition |
|---|---|
| InvalidOperationException | SetDockPosition — Если элемент управления не может выполнить запрошенный стиль док-станции. |
См. также
- Общие сведения о шаблонах элементов управления модели автоматизации пользовательского интерфейса
- Поддержка шаблонов элементов управления в поставщике автоматизации пользовательского интерфейса
- Шаблоны элементов управления модели автоматизации пользовательского интерфейса для клиентов
- Общие сведения о дереве модели автоматизации пользовательского интерфейса
- Использование кэширования в модели автоматизации пользовательского интерфейса