停靠控件模式

介绍实现 IDockProvider 的准则和约定,包括有关属性和方法的信息。 Dock 控件模式用于公开停靠容器中控件的停靠属性。

停靠容器是一个可让你水平或垂直地在彼此之间相对排列子元素的控件。 下图显示了一个包含两个子元素的停靠容器。 有关实现此控件模式的控件示例,请参阅 控件类型及其支持的控件模式

显示具有两个停靠子级的停靠容器的屏幕截图

本主题包含以下各节:

实现准则和约定

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

  • IDockProvider 不公开停靠容器的任何属性或停靠在停靠容器中与当前控件相邻的控件的任何属性。
  • 控件根据其当前的 z 顺序彼此相对停靠;控件的 z 顺序位置越高,则其距停靠容器的指定边缘就越远。
  • 如果调整了停靠容器的大小,则容器内的停靠控件将沿着最初的停靠边缘重新定位。 停靠控件还将根据其 DockPosition 属性的停靠行为调整大小以填充容器中的任何空间。 例如,如果指定 了DockPosition_Top ,则控件的左右两侧将展开以填充任何可用空间。 如果指定 了DockPosition_Fill ,则控件的所有四个边都将展开以填充任何可用空间。
  • 在具有多个监视器的系统上,控件应该停靠在当前监视器的左侧或右侧。 如果这不可能,则控件应该停靠在最左侧监视器的左侧或最右侧监视器的右侧。

IDockProvider 的必需成员

实现 IDockProvider 接口需要以下属性和方法。

必需的成员 成员类型 说明
DockPosition 属性
SetDockPosition 方法

 

没有与此控件模式关联的事件。

控件类型及其支持的控件模式

UI 自动化控件模式概述

UI 自动化树概述