停靠控件模式

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

停靠容器是一个控件,允许你相对地水平和垂直排列子元素。 下图显示了一个具有两个子元素的停靠容器。 有关实现此控件模式的控件示例,请参阅 控件类型及其支持的控件模式

屏幕截图,其中显示了两个停靠子容器的停靠容器

本主题包含以下部分。

实施准则和约定

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

  • IDockProvider 不会公开停靠容器的任何属性,也不会公开停靠容器中与当前控件相邻的控件的任何属性。
  • 控件根据控件的当前 z 顺序相互停靠;其 z 顺序放置越高,它们越远于停靠容器的指定边缘。
  • 如果调整停靠容器的大小,容器中的任何停靠控件将重新定位到最初停靠到的同一边缘。 停靠控件还将调整大小,以根据容器中 DockPosition 属性的停靠行为填充容器中的任何空间。 例如,如果指定了 DockPosition_Top,控件的左侧和右侧将展开以填充任何可用空间。 如果指定了 DockPosition_Fill,控件的所有四侧都将展开以填充任何可用空间。
  • 在多监视器系统上,控件应停靠在当前监视器的左侧或右侧。 如果不可能,它们应停靠在最左侧监视器的左侧或最右侧的监视器的右侧。

IDockProvider 所需的成员

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

必需成员 成员类型 笔记
DockPosition 财产 没有
SetDockPosition 方法 没有

 

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

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

UI 自动化控件模式概述

UI 自动化树概述