实现 UI 自动化 Dock 控件模式

更新：2007 年 11 月

本主题介绍实现 IDockProvider 的准则和约定，其中包括有关属性的信息。本主题的结尾列出了指向其他参考资料的链接。

DockPattern 控件模式用于公开停靠容器内控件的停靠属性。停靠容器是一个可以水平或垂直地在彼此之间相对排列子元素的控件。有关实现此控件模式的控件示例，请参见 UI 自动化客户端的控件模式映射。

Visual Studio 中的停靠示例，其中“类视图”窗口为 DockPosition.Right，“错误列表”窗口为 DockPosition.Bottom

具有两个停靠子级的停靠容器。

本主题包括下列各节。

实现准则和约定

实现 Dock 控件模式时，请注意以下准则和约定：

IDockProvider 没有公开停靠容器的任何属性，或者没有公开停靠在停靠容器内当前控件旁边的控件的任何属性。
控件根据其当前的 z 顺序彼此相对停靠；控件的 z 顺序位置越高，则其距停靠容器的指定边缘就越远。
如果调整了停靠容器的大小，则容器内的停靠控件将沿着最初的停靠边缘重新定位。停靠的控件也将调整大小，以根据其 DockPosition 的停靠行为来填充容器内的任何空间。例如，如果指定了 Top，则控件的左边和右边将会扩展以填充任何可用空间。如果指定了 Fill，则控件的所有四个边都将扩展以填充任何可用空间。
在具有多个监视器的系统上，控件应该停靠在当前监视器的左边或右边。如果这不可能，则控件应该停靠在最左边监视器的左边或最右边监视器的右边。