Note注意

如果 DockManager 寄宿在非托管窗口内,则不支持 自动隐藏功能

自动隐藏功能提供了模仿 Microsoft Visual Studio .NET IDE 中停靠窗口行为的功能。 如果允许使用 停靠面板 的自动隐藏功能,则当鼠标指针离开面板的区域时,该面板被自动隐藏。 停靠面板被隐藏在窗体的最近边缘。 例如,如果某个面板被停靠在窗体的右边缘,则它将被隐藏在右边缘。

DockManager.Form 属性引用的窗体 (或用户控件) 将把一个栏显示在面板所隐藏到的边缘。 这些栏呈现了 自动隐藏容器,在其中包含了与被隐藏面板相对应的按钮。 每个按钮都显示了与停靠面板相关的标题和图像。 当最终用户把鼠标指针指向其中的一个按钮时,相关的面板将变得可视。

通过单击显示在面板标题内的自动隐藏按钮 ,最终用户可以启用自动隐藏功能。 注意,自动隐藏按钮仅当停靠管理器的和该面板的 BaseDockOptions.ShowAutoHideButton 选项被设置为 true 时才被显示。 也可以通过代码把面板的 DockPanel.Visibility 属性设置为 DockVisibility.AutoHide 值来启用自动隐藏功能。 一旦面板的自动隐藏功能被启用,则该面板自动被添加到停靠管理器的 DockManager.HiddenPanels 集合中,此集合用于控制自动隐藏面板。

下面的插图举例说明了如何启用自动隐藏功能,以及如何显示被隐藏的停靠面板。

在启用自动隐藏功能之后,停靠面板被隐藏的方式由 DockingOptions.HideImmediatelyOnAutoHide 属性的值来确定。 如果该属性的值被设置为 true,则停靠面板立即被隐藏。 否则,使用滑动动画效果隐藏停靠面板,并且仅当鼠标指针已经离开停靠面板的区域之后才隐藏 (默认的行为)。

即使自动隐藏功能已经被启用,当鼠标指针离开其区域时,活动停靠面板也不会被自动隐藏。 通过单击停靠面板的标题,或把焦点设置到停靠面板内的任一控件,可以激活该面板。 通过单击在 自动隐藏容器 内显示的、与自动隐藏的停靠面板相关的按钮,也可以激活该面板。 最后,通过代码把停靠面板指派到停靠管理器的 DockManager.ActivePanel 属性,也可以激活该面板。

Expand image参阅