标题按钮
停靠面板能显示标题栏。 标题栏显示了该面板的标题和一组允许最终用户操作停靠面板的按钮 (隐藏、最大化和关闭它们)。
停靠管理器提供了一组 Boolean 值属性,来指定与停靠面板相关的哪些按钮可以显示。 可以通过 DockManager.DockingOptions 属性来访问这些属性。 下表详细描述了每个属性。
属性 | 说明 |
---|---|
BaseDockOptions.ShowCloseButton | 指明关闭按钮是否可以被显示在停靠面板的标题栏内。 个别停靠面板的 关闭 按钮可以通过把它的 Options.ShowCloseButton 选项设置 false 来进行隐藏。 |
BaseDockOptions.ShowMaximizeButton | 指明最大化按钮是否可以被显示在停靠面板的标题栏内。 个别停靠面板的 最大化 按钮可以通过把它的 Options.ShowMaximizeButton 选项设置为 false 来进行隐藏。 |
BaseDockOptions.ShowAutoHideButton | 指明自动隐藏按钮是否可以被显示在停靠面板的标题栏内。 个别停靠面板的 自动隐藏 按钮可以通过把它的 Options.ShowAutoHideButton 选项设置为 false 来进行隐藏。 |
下面的小节详细描述了每种按钮类型。
关闭按钮
关闭按钮用于隐藏停靠面板。 当最终用户按下关闭按钮时,面板被隐藏。 这些面板包含在已隐藏面板集合中,使用索引符号,该集合可以通过停靠管理器的 DockManager.HiddenPanels 属性进行访问。
注意,关闭按钮的行为也可以通过接管停靠管理器的 DockManager.ClosingPanel 事件进行控制。 当停靠面板的关闭按钮被按下时,此事件发生。 此事件提供了一个参数,该参数允许撤销默认的行为,并执行您自己的替代代码。 请参阅该事件的说明来获得细节。
当停靠面板呈现一个 标签式容器 时,按下它的 关闭 按钮可以关闭当前的活动停靠面板或标签式容器及其子面板。 这些行为由 DockingOptions.CloseActiveTabOnly 选项控制,可以通过停靠管理器的 DockManager.DockingOptions 属性来访问这些选项。
自动隐藏按钮
当停靠面板不在浮动模式中时,自动隐藏按钮被显示在停靠面板的标题栏内。 按下自动隐藏按钮将激活该面板的自动隐藏功能。 要获得关于自动隐藏功能的细节,请参阅 自动隐藏功能 主题。
最大化按钮
当停靠面板被包含在 分隔式容器 中时,在标题栏内显示最大化按钮。 在单击此按钮之后,相应的停靠面板成为该容器的活动子面板。 这意味着面板被最大化来填充该容器的整个客户区。 再次单击此按钮将把面板恢复为先前的大小。
也可以在代码中最大化面板。 要完成此任务,必须把该面板指派到它的主控分隔式容器的 DockPanel.ActiveChild 属性。