全面剖析Java 6中新型模态对话框API

全面剖析Java 6中新型模态对话框API

　　作者：朱先忠编译

　　一、引言

　　对话框，是指一个最顶层的拥有标题和边框的弹出窗口，典型地应用于用户进行某种形式的输入操作。在JDK 5.0和早期版本中，构建一个对话框时，它必须拥有一个作为它的所有者窗口的框架窗口或另一个对话框，即使窗口是不可见的。当用户最小化一个可见对话框的所有者窗口时会自动隐藏该对话框；而当用户随后恢复所有者窗口时，该对话框再次出现。

　　一个对话框可以是无模式的也可以是模式的。除了该对话框的所有者的窗口之外，模式对话框将阻止在应用程序中其它顶层窗口的输入。模式对话框捕获窗口焦点直到其被关闭为止（经常响应于一次按钮点击）。另一方面，一个无模式对话框允许用户改变它的状态，而此时其它窗口仍然可拥有焦点。后者常用于工具栏窗口中，例如你在一个图像编辑程序中所见的。

　　在JDK 5.0和早期版本中的模态模型有一些局限。而且，这种模态模型也存在一些问题。最著名的问题涉及到JavaHelp工具窗口。JavaHelp，Java应用程序中提供帮助信息的API，使用独立的窗口来显示所有的必要信息。然而，如果应用程序显示任何模式对话框，例如一标准Save As对话框，那么该对话框将阻止用户与JavaHelp工具窗口进行交互。

　　但是Java 6，代码名称为Mustang，已经通过一种新的抽象窗口工具箱(AWT)模态模型解决了此问题以及其它几个问题。这种新型模型允许开发者根据其选择的模态类型指定范围或限制一个对话框的模态阻断。如此模态类型也允许窗口和对话框成为真正的无父窗口，也即，拥有一个null父窗口，它可以帮助限制窗口的范围和对话框的模态。

　　二、模态类型

　　Java 6支持四种模态类型：

　　·无模式。无模式对话框在自己为可见时并不阻断任何其它窗口。

　　·文档-模式。文档-模式对话框阻断所有的来自同一文档的窗口，除了那些来自于它的子层次上的窗口外。在此意义中，一个文档是指一个窗口层次-框架窗口，对话框等等，它们共享一个文档根窗口。文档根窗口是所有没有所有者的最顶级窗口。

　　·应用程序-模式。应用程序-模式对话框能够阻断同一应用程序中的所有窗口，除了那些来自于它的子层次上的窗口外。如果在浏览器中激活若干applet，那么浏览器将把它们当作独立的应用程序或者作为一个单一的应用程序。具体情况依赖实现的具体环境。

　　·工具箱-模式。工具箱-模式对话框能够阻断所有的运行于同样的工具箱中的窗口，除了那些来自于它的子层次上的窗口外。如果激活多个applet，那么它们都运行于同样的工具箱上。因此，从applet中显示的工具箱-模式对话框可能影响其它的applet。

　　正如以前的JDK一样，一个对话框在缺省情况下是无模式的。但是如果你在Mustang中构造一个模式对话框的话，现在它将缺省使用应用程序-模式类型。另外，模式和无模式对话框的行为已经在Mustang作了改变，它们可以一直出现在其父窗口的顶部。

　　模态优先权是由阻断强度决定的。这种模态优先权帮助处理两个对话框可见并且能够彼此阻断的情形。优先权按升序排列分别是：无模式，文档-模式，应用程序-模式和工具箱-模式。这种优先权自然地反映了一个对话框的范围阻断的嵌套情形。一个无模式对话框有一个空范围的阻断。文档-模式对话框的范围阻断是在特定的应用程序中完成的，并且所有的应用程序是运行于一种工具箱中。图1展示了这样的一个例子。

图1:对话框的模态优先权

　　 注意，这种新型的模态模型并没有实现一个系统模态，这将会阻断(Java或其它)所有被显示在桌面上的应用程序，而只有一个模式对话框处于活动状态。

　　 三、了解新的构造器

　　能提供真正无父窗口而不中断向后兼容对于AWT开发小组来说是一个挑战。在JDK 5.0及以前的版本中，允许传递null作为JDialog或Jwindow的父窗口。这意味着，一不可见的共享所有者的框架窗口将成为这个对话框或窗口的父窗口。这个共享所有者的框架窗口的创建是为了创建无父窗口对话框。这种情况直到Java SE 6才得以成功-Java SE 6引入了新型的文档-模式对话框能够阻止所有的窗口使用相同的文档。

　　因而，工具箱会知道这样的对话框或窗口是没有null父窗口的。在Mustang中，仍然允许传递null作为一个父窗口到旧式的JDialog或JWindow构造器中。并且这可以完成相同的事情：其成为共享的所有者框架窗口而不是成为父窗口，这也照顾了向后兼容问题。然而，现在能把null传递到Dialog或Window构造器中，而且也能传递到新的JDialog或JWindow构造器中，这意味着这些对话框能够真正成为无父窗口。

　　下面列举的是一些比较有用的构造器：

　　·JDialog(Dialog owner)

　　　创建一个无标题并用一个指定的对话框作为其父窗口的无模式对话框

　　·JDialog(Dialog owner，boolean modal)

　　　用指定的所有者Dialog和模态创建一个具有指定的模态和所有者对话框的对话框

　　·JDialog(Dialog owner，String title)

　　　创建一个具有指定的标题和所有者对话框的无模式对话框

　　·JDialog(Dialog owner，String title，boolean modal)

　　　创建一个具有指定的标题，模态和所有者对话框的对话框

　　·JDialog(Dialog owner，String title，boolean modal，GraphicsConfiguration gc)

　　　创建一个具有指定的标题，模态和所有者对话框和GraphicsConfiguration的对话框

　　·JDialog(Frame owner)

　　　创建一个无标题但用指定的框架作为其所有者的无模式对话框

　　·JDialog(Window owner，String title，Dialog.ModalityType modalityType)

　　　创建一个具有指定的标题，模态和所有者窗口的对话框

　　有关这里每个构造器的更多细节请参考Mustang有关文档。

 

　　四、 与所有者窗口一同工作

　　如前面所提及的，当一个窗口或一个对话框是另一个窗口的父亲时，就称为该父组件"拥有"它的孩子。在此，当在新的模态模式下与所有者窗口一同工作时，你应该注意几件事情：

　　·创建一个没有所有者的文档-模式对话框。在这种情况中，因为Dialog是Window的一个子类；所以，如果一个Dialog实例没有所有者的话，它自动地成为该文档的根。这样，如果这个对话框是文档-模式的，那么它的阻断范围是空的，并且其行为就象一个无模式对话框。

　　·创建一个有所有者的应用程序-模式或工具箱-模式对话框。一个应用程序-模式或文档-模式对话框的阻断范围并不依靠它的所有者。在这种情况中，所有者所唯一影响的是Z-顺序（顶级组件的相对顺序）。如果你有两个窗口，一个遮住另一个，第一个窗口位于第二窗口上面，那么最顶端的窗口通常是一个活动的窗口。一个相关概念是"总是位于顶层"，这时一个窗口总是出现在系统中所有其它窗口之上。对话框总是会位于它的所有者的上部。

　　·在运行时刻改变模态类型。改变一可见的对话框的模态类型可能没有什么影响，直到该对话框被隐蔽并且被再次显示。

　　下列代码实例展示了新型的模态API的应用，其中包括现在可灵活在应用于对话框窗口的java.awt.Dialog.ModalExclusionType和 java.awt.Dialog.ModalityType。图2显示出当你运行该代码后的最终结果。

import java.awt.*; import java.awt.event.*; import sun.awt.*; public class ModalityDemo2 { // 第一个文档(red):框架，无模式对话框，文档-模式对话框 private static Frame f1; private static Dialog d11; //……省略，详见所附源码文件

图2: 被阻断的和未被阻断的对话框

　　一个使用DOCUMENT_MODAL的对话框会阻止相同文档中的所有顶层窗口的输入，除了它自己的子窗口层次之外。一个文档是一种没有所有者的顶层窗口。它可以被当作单个文档的子窗口和顶层窗口。因为每一个顶层窗口必须属于某文档，所以它的根可以在没有所有者的最顶层窗口中找到。

d22.setBounds(sw - 500 + 32， 232， 300， 200); d22.addWindowListener(closeWindow); d22.setLayout(new BorderLayout()); l = new Label("DOCUMENT_MODAL"); l.setBackground(Color.BLUE); l.setAlignment(Label.CENTER); l.setFont(labelFont); d22.add(l， BorderLayout.CENTER); //第三个文档 f3 = new Frame("Excluded Frame"); f3.setModalExclusionType( Dialog.ModalExclusionType.APPLICATION_EXCLUDE);

　　一个被设置为APPLICATION_MODAL的对话框将会阻断在同一Java程序中的所有的顶层窗口，除了它自己的孩子窗口层次之外。如果若干applet在一浏览器中被调用，那么可以把它们当作或者是独立的应用程序或者是单个的程序。这种行为的实现要依赖具体的环境而定。

　　注意，下面的f3不会被APPLICATION_MODAL和DOCUMENT_MODAL对话框所阻断。

f3.setBounds(32， sh - 200 + 32， 300， 200); f3.addWindowListener(closeWindow); f3.setLayout(new BorderLayout()); l = new Label("EXCLUDED FRAME"); l.setBackground(Color.GREEN); l.setAlignment(Label.CENTER); l.setFont(labelFont); f3.add(l， BorderLayout.CENTER); b = new Button("I'm alive!"); f3.add(b， BorderLayout.SOUTH); f3.setVisible(true); // 第四个文档 f4 = new Frame("Parent Frame"); f4.setBounds(sw - 300 + 32， sh - 200 + 32， 300， 200); f4.addWindowListener(closeWindow); f4.setLayout(new BorderLayout()); l = new Label("FRAME"); l.setBackground(Color.GRAY); l.setAlignment(Label.CENTER); l.setFont(labelFont); b = new Button("Show file dialog"); b.addActionListener(new ActionListener() { 　public void actionPerformed(ActionEvent e) { 　　fd4.setVisible(true); 　} }); f4.add(b， BorderLayout.SOUTH); f4.setVisible(true); fd4 = new FileDialog(f4， "File Dialog"， FileDialog.LOAD); 为了向后兼容性起见，File对话框缺省是APPLICATION_MODA。 fd4.setBounds(sw - 400 + 32， sh - 300 + 32， 300， 200); } }

　　 五、 有关AWT特性

　　下面是其它一些在使用新的模态模态时要了解的AWT特性。

　　(一) 总在最上面

　　当一个并不总是位于顶层的模式对话框阻断一个总是位于顶层的窗口时，它们的相对Z-序未特别指出并且是平台依赖的。下列实例表明这个问题：

JFrame f = new JFrame(...); f.setAlwaysOnTop(true); f.setVisible(true); JDialog d = new JDialog(frame， "Dialog"， true); d.setVisible(true);

　　这段代码制造了一种矛盾：一方面，d必须位于f之上（因为它是一个模式对话框并且应该阻断f）。而另一方面，f必须必须位于d之上，因为f被设置为总是位于顶层，而d不是。如此情形是未特别指出的。然而，总是有解决办法：如果d也被设置为总是位于顶层(d.setAlwaysOnTop(true))，那么该对话框将在任何时候位于框架窗口之上。

　　(二) toFront()和toBack()方法

　　一个模式对话框应该总是位于所有的被其阻断的窗口之上。这样，如果一被阻断的窗口被送到前面，那么它的阻断对话框，如果有的话，也被送到前面并且位于被阻断的窗口之上。同样，如果一模式对话框被送到后面，那么所有它的被阻断的窗口被送到后面以使其位于阻断对话框下面。

　　(三) 最小化，最大化和关闭被阻断的窗口

　　当一个模式对话框阻断一个窗口时，用户可能无法最小化或最大化被阻断的窗口。然而，实际行为并未特别指出并且是平台依赖的。在任何情况下，用户都不能交互式地关闭被阻断的窗口。但是它能被通过编程方式关闭-通过在被阻断的窗口上调用setVisible(false)或dispose()方法。

　　(四) 激活被阻断的窗口

　　当用户选择一个被阻断的窗口时，它有可能连同阻断模式对话框一起被送到前端，然后它成为当前活动窗口。然而，实际行为并未特别指出并且是平台依赖的。

　　(五) 隐藏模式对话框

　　当具有当前焦点的模式对话框被隐藏时，它的所有者未被阻断而有可能成为活动窗口。然而，实际行为并未特别指出并且是平台依赖的。如果要被隐藏的模式对话框不具有焦点，那么活动窗口保持不变。

　　(六) 安全性

　　为了显示工具箱-模式对话框，需要一种特殊的AWTPermission，toolkitModality。例如，这将防止从applet中显示的模式对话框被浏览器或JWS（Java Web Start）的软件所阻断。

　　相同的权限需要用于从工具箱模态中排除一个窗口。例如，这将防止一个从applet中显示的对话框被浏览器或JWS的模式对话框所阻断。

　　(七) 平台支持

　　有两个java.awt.Toolkit方法允许你检查是否当前平台支持特定的模态特征：

　　·isModalityTypeSupported(modalityType)，返回是否给定的模态类型为当前平台所支持。如果不支持模式M并且一个对话框被设置为M-modal，那么其行为就象一个无模态对话框。

　　·isModalExclusionTypeSupported(modalExclusionType)，返回是否给定的模态exclusion类型为当前平台所支持。如果不支持exclusion类型E并且一个窗口被标记为E-excluded，那么这没有任何影响。

　　 六、兼容性

　　默认的模态类型是应用程序模式，它被如Dialog.setModal(true)，Dialog(owner，true)等API所用调用。在JDK 6以前，默认类型是工具箱-模式，但是在应用程序模态和工具箱模态之间的唯一区别在于从JWS软件中激活applet和应用程序方面。

　　注意：任何Java SE平台API的增加或对其说明的改进必须经JSR 270专家组的过目和同意。