跳转至

Dock 管理器和 Dock 项目

DockManager 组件允许您创建受 Visual Studio 启发的对接 UI。停靠窗格和 Document 窗格是停靠 UI 的基本元素。停靠窗格用于实现工具面板。Document 窗格专为显示窗口的主要内容而定制。您可以将多个 Document 窗格组合在一个特殊容器中,以实现选项卡式 MDI(多文档界面)。

docking-ui-dockpanes-and-documentpanes-v2

Docking 库支持用户在代码中对 dock 项目(面板和文档)进行运行时操作。用户可以使用拖放操作和上下文菜单重新排列布局或 dock 项目,并使它们浮动。相邻项目之间的拆分器允许运行时调整大小操作。面板标题中的”固定”按钮保留了自动隐藏功能,使用户可以折叠和恢复面板。

借助 Docking 库,您可以使用 MVVM 设计模式通过停靠窗格和 Document 窗格填充对接界面,并为窗格提供内容。

开始使用 Docking UI

以下主题演示如何从头开始创建示例对接接口:

停靠窗格

停靠窗格(DockPane 对象)允许您创建可停靠和浮动工具面板。面板可以并排显示或作为选项卡显示。他们还支持自动隐藏功能。

dockingui-dockpanes

要在 XAML 或代码隐藏中创建 Docking UI,需要将 Dock 窗格组合到容器(组)中。例如,您可以组合 DockGroup 容器中的项目,以水平或垂直方式将它们相邻显示。如果您将面板组合在 TabbedGroup 容器中,它们将显示为选项卡。容器还可以包含其他容器作为子容器。

请参阅以下主题以了解更多信息:Dock 面板与容器

Document 窗格

使用 Document 窗格(DocumentPane 对象)来显示窗口的主要内容。如果您创建多个 Document 窗格,则可以将它们合并到一个 DocumentGroup 容器中。 DocumentGroup 是一个特殊容器,它将 Document 窗格显示为选项卡(类似于用于将停靠窗格显示为选项卡的 TabbedGroup 容器)。

dockingui-documentpanes

Document 窗格可以设为浮动。与 Dock 窗格不同,Document 窗格不支持自动隐藏功能。

您可以创建两个或多个 DocumentGroup 容器,每个容器显示其自己的一组 Document 窗格。

请参阅以下主题以了解更多信息:Document 面板

停靠提示

当用户将停靠窗格或 Document 窗格拖动到另一个面板或容器上时,DockManager 会显示有助于执行停靠操作的 dock 提示。将该项放到特定提示上会将该项停靠在相应的位置。

docking-dock-hints

如果用户将该项放在 dock 提示之外,则该项会变为浮动。

上下文菜单

Docking 库为 Dock 窗格和 Document 窗格提供内置上下文菜单。这些菜单包含在窗格上执行常见 dock 操作的命令。

dockingui-contextmenus

处理 DockManager.DockItemContextMenuOpening 事件以自定义上下文菜单,或阻止显示它们。

阻止对 Dock 项目的某些操作

Dock 窗格和 Document 窗格在其标题中显示预定义按钮,用于在窗格上执行常见操作。

dockpane-headerbuttons

DockManager 提供选项和事件,用于控制 dock 窗格上的操作。有关更多详细信息,请参阅以下部分:Dock 面板与容器 - 停靠面板的运行时选项

保存和恢复窗格布局

您可以将当前的 dock 布局保存到流中,然后在需要时恢复。此功能允许您在用户关闭应用程序时保存布局,并在下次应用程序运行时重新加载保存的布局。有关详细信息,请参阅以下主题:保存和恢复面板布局

另请参阅



* 本页面使用机器翻译技术翻译。