使用Swing进行动态界面设计

Posted 2023-05-11

参考技术A

　　Swing 工具包提供各种用于创建用户界面的工具和几乎令人眼花缭乱的选项 这些选项用于在程序生存期间修改界面 小心地使用这些功能可以导致界面能够适应用户的需要并简化交互过程 粗心地使用同样的功能可以导致非常混乱或彻底不可用的程序 本文介绍动态 UI 的技术和体系 并提供有关构建有效的界面的帮助 您将修改随 Sun JDK 一起提供的基于 SwingSet 示例应用程序的源代码;此应用程序的 UI 使用许多动态的特性并且可以作为理解它们的极好的起点

　　 禁用小部件

　　动态 UI 的最简单形式是使不可用的菜单项或按钮变灰的 UI 禁用 UI 小部件与禁用所有小部件的方法都是相同的 setEnabled() 函数是 Component 类的一个功能 清单 显示了禁用按钮的代码

　　 清单 禁用按钮

　　 button setEnabled(false);

　　正如您看到的 十分简单 关键问题是何时应该 启用或禁用一个按钮 通常的设计决策是当按钮不可用时禁用它 例如 当一个文件从上一次保存以来还没有被修改时 很多程序禁用 Save 按钮(以及任何相应的菜单项)

　　关于禁用按钮的重要警告是要记住在适当的时候重新启用它们 例如 如果在单击按钮和按钮的动作完成之间有一个确认步骤 即使确认失败也应该重新启用按钮

　　 　调整范围

　　有时 应用程序需要动态地调整数值小部件的范围 例如 Spinner 或者 Slider 这可能比它看起来要复杂许多 特别是 Slider 有二级功能 —— 刻度 刻度间隔和标签 —— 这些可能需要随着范围的调整而加以调整以避免灾难发生

　　SwingSet 示例没有进行任何一项调整 所以您需要通过把 ChangeListener 连接到一个可以修改其他滑块的滑块来修改它 输入新的 SliderChangeListener 类 如清单 所示

　　 清单 更改滑块的范围

　　 class SliderChangeListener implements ChangeListener        JSlider h;        SliderChangeListener(JSlider h)               this h = h;               public void stateChanged(ChangeEvent e)            JSlider js = (JSlider) e getSource();            int i = js getValue();            h setMaximum(i);            h repaint();       

　　当创建第三个水平滑块时(最初示例中的滑块在每个单位处带有标记 在 和 等处带有标签) 另外还创建了一个新的 SliderChangeListener 它把滑块作为构造器参数传递 当创建第三个垂直的滑块(范围从 到 )时 新的 SliderChangeListener 作为变更监听器添加到它 这大致按预期的那样工作 调整垂直滑块改变了水平滑块的范围

　　不幸的是 刻度和标签根本不能很好地工作 当范围变得不是太大时 每五个刻度处的标签能正确地工作 但是刻度 处的额外标签很快成为一个可用性问题 如图 所示

　　 图 一起运行的标签

　　

　　 更新刻度和标签

　　明显的解决方案是 只要滑块的最大值被更新 就在水平滑块上简单地设置刻度间隔 如清单 所示

　　 清单 设置刻度间隔

　　 // DOES NOT WORK int tickMajor tickMinor; tickMajor = (i > ) ? (i / ) : ; tickMinor = (tickMajor > ) ?  (tickMajor / ) : tickMajor; h setMajorTickSpacing(tickMajor); h setMinorTickSpacing(tickMinor); h repaint();

　　目前清单 是正确的 但是它没有引起画在屏幕上的标签的任何变化 必须使用 setLabelTable() 分别设置标签 添加额外一行修复它

　　 h setLabelTable(h createStandardLabels(tickMajor));

　　这仍然出现在刻度 处存在最初设置的标签这样的错误 当然本来的意图是想在滑块的最右端始终有一个标签 可以通过删除旧的标签(在设置新的最大值之前)然后添加一个新的标签达到这一目的 此代码 几乎 可以工作

　　 清单 替换标签

　　 public void stateChanged(ChangeEvent e)        JSlider js = (JSlider) e getSource();        int i = js getValue();        // clear old label for top value        h getLabelTable() remove(h getMaximum());        h setMaximum(i);        int tickMajor tickMinor;        tickMajor = (i > ) ? (i / ) : ;        tickMinor = (tickMajor > ) ? (tickMajor / ) : tickMajor;        h setMajorTickSpacing(tickMajor);        h setMinorTickSpacing(tickMinor);        h setLabelTable(h createStandardLabels(tickMajor));        h getLabelTable() put(new Integer(i)        new JLabel(new Integer(i) toString() JLabel CENTER));        h repaint();

　　如果我已经告诉过您一次 那么我就已经告诉您两次了

　　我使用几乎 的意思是 虽然清单 中的代码删除了刻度 处的标签 但是它没有在刻度 i 处添加新标签;相反 只能看到间隔为 tickMajor 的标签 首先此解决方法相当令人讨厌

　　 清单 强迫显示更新

　　 h setLabelTable(h getLabelTable());

　　这个看起来无意义的操作实际上有重大的作用 每当设置标签表时就生成滑块的标签 没有为了修改对表进行特殊回调 所以添加到表中的新值不必产生效果;很显然 清单 中的空操作具有使 Swing 知道它必须更新显示的副作用 (以免您认为这是我自己发明的 请注意最初的 SwingSet 代码包括这样一个调用 )

　　这只留下了一个问题 标签出现在滑块的末端这个非常合理的期望有时使两个标签互相直接相邻 乃至重叠 如图 所示

　　 图 滑块末端的重叠标签

　　

　　很多解决此问题的方法都是可行的 编写自己的代码以使用值来填充标签表并停止以前的序列以便序列中的最后标签与滑块的末端有一些隔离 我将把这个作为作业留给您

　　在许多情况下 为了启用和禁用菜单项而限制菜单修改是很实际的 此方法容易受到用于禁用项的常规警告的影响 避免由于偶然地禁用重要项而使程序处于不可用状态

　　添加或删除菜单项或子菜单也是可能的 修改 JMenuBar 没有这么容易;没有从工具栏上删除和替换单个菜单的接口 如果您想修改工具栏(而不是向最右端添加菜单) 需要制作一个新的工具栏并用它替换旧的工具栏

　　修改单个菜单会立即生效;您不必在将菜单连接到工具栏或另一个菜单之前构建一个菜单 当需要修改菜单选项的选择时 最容易的方法是修改选定的菜单 您可能仍然想添加或删除完整的菜单 并且这么做并不是特别难 清单 显示一个将菜单插入到菜单条中给定索引前的方法的简单示例 此示例假定要替换的 JMenuBar 连接到 JFrame 对象 但是任何能使您获得和设置菜单条的东西的工作方式都是一样的

　　 清单 把一个菜单插入到菜单条中

　　 public void insertMenu(JFrame frame JMenu menu int index)        JMenuBar newBar = new JMenuBar();        JMenuBar oldBar = frame getJMenuBar();        MenuElement[] oldMenus = oldBar getSubElements();        int count = oldBar getMenuCount();        int i;        for (i = ; i < count; ++i)               if (i == index)                      newBar add(menu);               newBar add((JMenu) oldMenus[i]);               frame setJMenuBar(newBar);

　　上面的代码我不是开始时就试图编成这样;这是最终的版本 已经很好地修复过了所以它能够运行并反映一些有趣的怪事 初看起来 实现此功能的明显方法似乎应该是使用 getComponentAtIndex() 但是这种方法已经受到了反对 幸运的是 getSubElements() 已经足够好 为 newBar add() 而进行到 JMenu 的强制类型转换可能是安全的 但是我不喜欢这样 getSubElements() 接口不仅对菜单条而且对菜单进行操作 菜单可能具有几种类型的子元素 JMenu 是可以添加到 JMenuBar 的惟一元素 所以必须把元素强制转换为 JMenu 以把它传递到 JMenuBar add() 方法 不幸的是 如果将来的 API 修订版允许将除 JMenu 类型之外的元素添加到 JMenuBar 就不再需要把返回的元素强制转换 JMenu了

　　清单 中的代码反映了另外一个相当微妙的界面怪事;菜单数必须提前缓存起来 当把菜单添加到新的菜单条时 它们从旧的菜单条中被删除 虽然看起来相似 但是清单 中的代码不能工作 因为循环提前结束了:

　　 清单 循环结束太早

　　 // DOES NOT WORK for (i = ; i < oldBar getMenuCount(); ++i)        if (i == index)               newBar add(menu);        newBar add((JMenu) oldMenus[i]);

　　清单 中的循环只复制一半数量的菜单 例如 如果开始菜单条上有 个 菜单 它复制前面的两个菜单 复制完第一个菜单以后 i 的值为 并且 getMenuCount() 返回 ;在复制完第二个菜单以后 i 的值为 并且 getMenuCount() 返回 因此循环结束 我没有找到任何介绍通过向菜单条添加菜单从而从另一个菜单条删除菜单这样的特性的文档 因此可能不是有意这样 但是 它很容易达到这个目的

　　从菜单条删除菜单稍微容易一些;只是把所有其他的菜单从旧的菜单条复制到新的菜单条 就完成了删除菜单 很容易!

　　如果界面使用了很多动态菜单更新 创建一组菜单条并在它们之间切换而不是一直动态地更新它们也许会更好一些 但是 如果如此快地改变菜单 可能会使用户完全发疯

　　勘误 在本文的草稿阶段 我忽略了 JMenuBar 类的继承方法的列表 其实 它有 remove 和 add 方法可以用来在指定的索引处进行删除和插入 另外一个教训是 查看继承的方法而不仅仅是特定于类的方法

　　 调整窗口大小

　　所幸的是对于大多数情况 窗口大小调整是自动进行的 但是需要考虑调整大小产生的一些影响 在非常小的窗口中 按钮条 菜单条和类似功能可能变成有问题的 管理程序自身的图形面板需要响应调整大小事件 让 Swing 处理对 UI 元素的包装 但是要密切注视组件的大小;不要获取一次组件的尺寸然后就一直使用这些值

　　更微妙的地方是 一些设计决策(例如滑块上刻度的密度)可能被适度地更新以响应窗口大小调整事件 像素宽度的滑块不能具有像 像素宽度的滑块那样多的可读标签 您可能想通过添加全新的有用功能来让 UI 更进一步用在大型显示器上

　　但是 在多数情况下 可以忽略窗口大小调整 您不应该做的是不必要地阻止或重写它 布局代码中的窗口一侧的便捷工具不是必需的 最小的窗口大小可能是无可厚非的 但是要让人们能把窗口调整到他们所需要的大小

　　 一般原则

　　Swing 工具包在 UI 设计方面提供了很大的灵活性 如果小心地使用 动态更新界面的选项能够极大地简化该界面;例如 只有应用菜单的选项时 用户才能容易地显示菜单

　　不幸的是 一些 API 的特性可能使此方法产生一些离奇的行为 并且副作用和相互影响并不总是像您期望的那样记录下来 如果您有使用动态界面的想法 就要准备在调试上花费一些额外的时间 您可能从 Swing 库的困境中走出来并发现自己需要处理出人意料的行为和/或 bug

　　不要让缺乏明显的实现让您气馁 像本文的 JMenuBar 示例所显示的 即使当 API 不支持某个任务时 您也能自己实现它 虽然有一点间接

　　尽量不要走极端 当动态 UI 让用户清楚它们的固有限制时 它们才能最好地发挥作用 理想的情况是 用户甚至可能不会注意到界面变化 如果他们能够使用程序的 Object 菜单的惟一时刻是当他们使某个对象被选择时 那么其余的时间他们将不会介意不存在该菜单

　　另一方面 如果存在这种可能性 用户不能猜测出一个选项不可用的原因 这时让用户尝试操作并获得包含信息的消息也许会更好 这对于一些操作尤其重要 如果保存选项被禁用 而我想保存数据 那么这不会发生作用 程序可能认为已经保存了数据 但是为什么不让我无论如何都保存它呢?如果存在不能保存文件的特殊原因 我可能想知道是什么原因

lishixinzhi/Article/program/Java/hx/201311/26042

使用WindowBuilder设计Swing程序

Swing程序表示Java的客户端窗体程序，除了通过手动编写代码的方式设计Swing程序之外，Eclipse中还提供了一种WindowBuilder工具，该工具是一种非常好用的Swing可视化开发工具，有了它，开发人员就可以像Visual Studio一样通过拖放组件的方式编写Swing程序了，下面对如何使用WindowBuilder开发工具设计Swing程序进行详细介绍。

A.1 下载WindowBuilder工具
下载WindowBuilder工具有两种方法，一种方法是直接下载集成WindowBuilder工具的Eclipse，另外一种是通过Install New Software安装，下面分别介绍。
? 下载集成WindowBuilder工具的Eclipse
在Eclipse官方网站的Eclipse下载页面提供了多种Eclipse工具，其中有一个“Eclipse IDE for Java Developers”选项，该项即集成了WindowBuilder工具，用户只需要根据自己的操作系统位数下载相应的版本即可，如图A.1所示。

图A.1下载集成WindowBuilder工具的Eclipse

? 通过Install New Software安装WindowBuilder工具
如果用户下载的Eclipse版本不是“Eclipse IDE for Java Developers”，这时想要使用WindowBuilder工具开发Swing程序就需要手动进行安装，步骤如下：
（1）打开Eclipse，在Eclipse菜单中选择“Help/About Eclipse”菜单，如图A.2所示。

图A.2　选择“Help/About Eclipse”菜单

（2）弹出“About Eclipse”对话框，该对话框中可以看到Eclipse的版本，如图A.3所示。

图A.3　查看Eclipse的版本
（3）在IE浏览器的地址栏输入网址http://www.eclipse.org/windowbuilder/download.php，进入Eclipse官网的WindowBuilder下载界面，如图A.4所示。

图A.4　WindowBuilder下载界面

（4）根据自己的Eclipse版本单击对应的“Release Version”下的“Update Site”中的link链接，这里选择“4.5（Mars）”版本，进入到一个空白页，复制该空白页的网址（http://download.eclipse.org/windowbuilder/WB/release/R201506241200-1/4.5/）

（5）打开Eclipse，在Eclipse菜单中选择“Help/ Install New Software”菜单，如图A.5所示。

图A.5　选择“Help/ Install New Software”菜单

（6）弹出Install对话框，如图A.6所示。

图A.6　Install对话框

（7）在Install对话框中单击Add按钮，弹出“Add Repository”对话框，如图A.7所示，该对话框中，在Name文本框中输入要安装的插件名称WindowBuilder；Location文本框中输入WindowBuilder工具的更新地址（即步骤（4）中复制的http://download.eclipse.org/windowbuilder/WB/release/R201506241200-1/4.5/）

图A.7　“Add Repository”对话框

（8）单击OK按钮，返回Install对话框，该对话框中选中WindowBuilder工具的更新内容，然后按照提示单击Next，即可将WindowBuilder工具安装到Eclipse中，如图A.8所示。

图A.8　安装WindowBuilder工具

A.2 使用WindowBuilder设计窗体
为Eclipse安装完WindowBuilder工具之后，就可以使用WindowBuilder设计Swing程序了，步骤如下：

（1）新建一个Java项目，在Java项目上单击右键，选择“New/Other”快捷菜单，如图A.9所示。

图A.9　选择“New/Other”快捷菜单

（2）弹出New对话框，该对话框中因此展开“WindowBuilder/Swing Designer”菜单，选中JFrame菜单项，如图A.10所示。

图A.10　选中JFrame菜单项

（3）单击Next按钮，进入“New JFrame”对话框，该对话框中输入相应的包名（Package）和窗体名称（Name），如图A.11所示。

图A.11　“New JFrame”对话框

注意：创建JFrame窗体时，必须依赖于某一个Java项目，即“New JFrame”对话框中的“Source folder”文本框不能为空，否则，将会出现如图A.12所示的错误提示。

（4）单击Finish按钮，即可创建一个JFrame窗体。创建完的JFrame窗体的java文件中，系统会自动生成部分代码，如图A.13所示。

图A.13　自动生成的JFrame窗体代码

（5）单击底部的Design选项卡，可以切换到可视化设计界面，如图A.14所示，该界面中有3个主要区域，分别是组件工具箱、窗体设计区和属性，其中，组件工具箱提供了设计Swing程序所需的布局管理器、容器和各种组件；窗体设计区主要用来对窗体进行可视化的设计；属性区域用来对窗体或者组件的相关属性进行设置，这样就省去了编写代码设置属性的过程，更加方便快捷。

图A.14　JFrame可视化设计界面
（6）在可视化设计界面中，用户可以根据自己的实际需要在窗体中绘制相应的组件，并对组件的属性进行设置，绘制组件的具体操作为：在左侧“组件工具箱”选中单击要显示在窗体上的组件，然后将鼠标移动到“窗体设计区”，会显示一个带绿色原点的鼠标形状，在某个区域单击鼠标左键，即可绘制一个相应的组件，如图A.15所示。

图A.15　在JFrame窗体中绘制组件

说明：创建完JFrame窗体后，默认的布局方式为BorderLayout边界布局，如果想要取消布局，可以直接在窗体设计区按Delete键删除，然后切换到.java文件（单击底部的Source选项卡），将setLayout方法的参数设置为null。