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

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

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

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

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

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

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

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

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

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

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

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

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

Исключения

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

См. также

• Обзор шаблонов управления автоматизацией пользовательского интерфейса
• Поддержка шаблонов управления в поставщике автоматизации пользовательского интерфейса
• Шаблоны элементов управления автоматизации пользовательского интерфейса для клиентов
• Обзор дерева автоматизации пользовательского интерфейса
• Использование кэширования в автоматизации пользовательского интерфейса