注释
本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息，请参阅 Windows 自动化 API：UI 自动化。
本主题介绍实现的 IDockProvider准则和约定，包括有关属性的信息。 主题末尾列出了指向其他引用的链接。
控件 DockPattern 模式用于公开停靠容器中控件的停靠属性。 停靠容器是一个控件，允许你相对地水平和垂直排列子元素。 有关实现此控件模式的控件示例，请参阅 UI 自动化客户端的控件模式映射。
Visual Studio 中的停靠示例，其中“类视图”窗口为 DockPosition.Right，“错误列表”窗口为 DockPosition.Bottom
实施准则和约定
实现 Dock 控件模式时，请注意以下准则和约定：
IDockProvider 不会公开停靠容器的任何属性，也不会公开停靠容器中与当前控件相邻的控件的任何属性。
控件根据控件的当前 z 顺序相互停靠;其 z 顺序放置越高，它们越远于停靠容器的指定边缘。
如果调整停靠容器的大小，容器中的任何停靠控件将重新定位到最初停靠到的同一边缘。 停靠的控件也将调整大小，以根据其 DockPosition的停靠行为来填充容器内的任何空间。 例如，如果 Top 指定，控件的左侧和右侧将展开以填充任何可用空间。 如果 Fill 已指定，控件的所有四侧将展开以填充任何可用空间。
在多监视器系统上，控件应停靠在当前监视器的左侧或右侧。 如果不可能，它们应停靠在最左侧监视器的左侧或最右侧的监视器的右侧。
IDockProvider 所需的成员
实现 IDockProvider 接口需要以下属性和方法。
| 必需成员 | 成员类型 | 注释 |
|---|---|---|
| DockPosition | 资产 | 没有 |
| SetDockPosition | 方法 | 没有 |
此控件模式没有关联的事件。
例外
提供程序必须引发以下异常。
| 异常类型 | 条件 |
|---|---|
| InvalidOperationException | SetDockPosition - 当控件无法执行请求的停靠样式时。 |