JIDE Docking Framework(窗口框架) 开发员技术手册

杰笛窗口框架 Docking Framework 杰笛窗口框架提供了一个功能强大且简单易用的工具窗口解决方案，正如用户在Visual Studio .NET IDE或者Eclipse IDE看到的一样。如果您的应用程序很简单，可能没有什么必要使用这个产品。但是对于很多用户来说，应用程序里面可能有很多的工具窗口，用户希望根据他们的需求，选择显示一些窗口，隐藏其它的窗口，而对于显示的窗口，他们又希望可以随意调整它们的大小、位置和状态。在这个情况下，杰笛窗口框架就非常有用了。事实已经证明，杰笛窗口框架是针对有限屏幕空间和复杂窗口布局问题的最有效的解决方案。自2002年底发行以来，全世界众多公司都选择了我们的窗口框架来管理他们应用程序的窗口。毫无疑问，它是目前市场上现有的最好的工具窗口解决方案。 利用Swing即插的LookAndFeel技术，我们制作了几种风格的杰笛窗口框架。在当前发行的版本中包括了类似Office 2003、Office 2007、Visual Studio.NET、Eclipse、Aqua、Xerto和默认的Swing Metal的LookAndFeel。用户可以根据喜好选择自己最喜欢的风格。 功能介绍 工具窗的特性 支持拖放功能 不受限的Dockable Window嵌入层 窗口的自动隐藏 可调整窗口的自动隐藏 浮动的Dockable Window 最大化Dockable Window 带通知的Dockable Window 可隐藏的中央工作空间 支持heavyweight 组件（比如说Java3D、 JOGL、ActiveX组件） 多种风格 Office 2007 风格 Office 2003 风格 Visual Studio .NET 风格 Eclipse 风格 Metal 风格 Aqua 风格 Xerto 风格 布局保存 可以用Java自带的pref保存或者加载布局 可以用文件保存或者加载布局 可以用InputStream和OutputStream （输入流和输出流）保存或者加载布局 可以列出所有前面保存的的布局 可以随时更换布局 ### JIDE Docking Framework(窗口框架)开发员技术手册 #### 概述 JIDE Docking Framework是一款专为Swing应用程序设计的高级框架，旨在帮助开发者轻松实现类似于Visual Studio .NET IDE或Eclipse IDE中的复杂窗口布局管理。该框架不仅支持多样的窗口布局方式，还提供了丰富的定制选项和外观主题，使开发者能够快速地集成到现有应用中，并显著提升用户体验。 #### 主要特点 - **强大的工具窗口管理**：JIDE Docking Framework为开发者提供了一个高效且直观的工具窗口解决方案，适用于那些具有复杂界面需求的应用程序。 - **灵活的窗口操作**：支持拖放功能、不限制的可嵌入窗口层数、自动隐藏、浮动窗口、最大化窗口等特性。 - **多种风格的主题**：内置多种外观风格，包括Office 2003/2007、Visual Studio .NET、Eclipse、Aqua、Xerto以及默认的Swing Metal风格，满足不同用户的审美偏好。 - **布局保存与恢复**：支持通过Java自带的偏好设置系统保存或加载布局，也可以通过文件或输入输出流进行布局的保存和恢复。 - **广泛的兼容性**：支持AWT/Swing的各种RootPaneContainer类型，如`JFrame`、`JWindow`、`JDialog`和`JApplet`，方便集成到各种应用场景中。 #### 核心概念与功能 - **Docking Manager**：这是整个框架的核心组成部分，用于管理所有的Dockable Frames。它维护着应用程序中所有可停靠窗口的列表，并负责安排这些窗口的位置和状态。 - **Dockable Frame**：代表一个可以停靠、浮动、隐藏或最大化的窗口。开发者可以通过简单的API操作添加、删除或改变这些窗口的状态。 - **Workspace Area**：位于主界面中心的工作区，通常用于展示主要的应用内容。它可以被隐藏，以便为更多的工具窗口腾出空间。 - **Layout Persistence**：为了保持用户的工作环境不变，JIDE Docking Framework提供了布局持久化功能，允许用户保存和加载他们的布局设置。 - **Perspectives**：这是一种更为高级的功能，允许用户在不同的预设布局之间切换，从而适应不同的工作流程需求。 #### 使用指南 1. **理解Docking Manager**： - `DefaultDockingManager`是该接口的一个实现，它负责管理所有的`DockableFrame`对象。 - 开发者可以通过调用相关方法来添加新的`DockableFrame`、改变窗口的布局或状态。 - 通过`DockingManager`可以获取当前活动的`DockableFrame`，以及进行跨Docking Manager的拖拽操作。 2. **添加Dockable Frame**： - 通过简单的API调用即可将新的`DockableFrame`添加到应用中。 - 可以定义初始布局，例如使用可视化设计器来设定窗口的初始位置和大小。 - 支持对已添加的`DockableFrame`进行操纵，包括移动、隐藏、最大化等操作。 3. **布局信息的持久化**： - 提供了多种方式来保存和加载布局信息，例如通过Java的首选项系统、文件系统或输入输出流。 - 用户可以选择保存多个布局，并随时切换到任何先前保存的布局。 4. **多Docking Manager的支持**： - 允许在同一个应用中使用多个`DockingManager`实例，以实现更复杂的布局和管理需求。 - 支持跨`DockingManager`的拖拽操作，提高窗口布局的灵活性。 5. **Look and Feel**： - JIDE Docking Framework内置了多种风格的主题，可以通过简单的配置切换。 - 开发者还可以自定义主题，以适应特定的操作系统环境或品牌需求。 #### 结论 JIDE Docking Framework为开发者提供了一套完整的工具集，用于创建高度定制化和交互式的Swing应用程序。无论是对于初学者还是经验丰富的开发者，该框架都能极大地简化复杂窗口管理的任务，并帮助构建出更加用户友好、功能强大的应用程序。