http://zetcode.com/tutorials/javaswingtutorial/swingdialogs/

对话框窗口或对话框是大多数现代 GUI 应用必不可少的部分。 对话被定义为两个或更多人之间的对话。 在计算机应用中，对话框是一个窗口，用于与应用“对话”。 对话框用于输入数据，修改数据，更改应用设置等。对话框是用户与计算机程序之间进行通信的重要手段。

在 Java Swing 中，我们可以创建两种对话框：标准对话框和自定义对话框。自定义对话框由程序员创建。 它们基于JDialog类。标准对话框是 Swing 工具箱中可用的预定义对话框，例如JColorChooser或JFileChooser。 这些是用于常见编程任务的对话框，例如显示文本，接收输入，加载和保存文件。 它们节省了程序员的时间，并增强了一些标准行为。

对话框有两种基本类型：模态对话框和非模态对话框。模态对话框阻止输入到其他顶级窗口。非模态对话框允许输入其他窗口。 打开文件对话框是模态对话框的一个很好的例子。 选择要打开的文件时，不应进行其他操作。 典型的非模态对话框是查找文本对话框。 能够在文本控件中移动光标并定义从何处开始查找特定文本很方便。

MessageDialog

消息对话框是向用户提供信息的简单对话框。 消息对话框是使用JOptionPane.showMessageDialog()方法创建的。

MessageDialogsEx.java

  1. package com.zetcode;
  3. import javax.swing.GroupLayout;
  4. import javax.swing.JButton;
  5. import javax.swing.JComponent;
  6. import javax.swing.JFrame;
  7. import javax.swing.JOptionPane;
  8. import javax.swing.JPanel;
  9. import java.awt.EventQueue;
  11. import static javax.swing.GroupLayout.DEFAULT_SIZE;
  13. public class MessageDialogsEx extends JFrame {
  15.     private JPanel pnl;
  17.     public MessageDialogsEx() {
  19.         initUI();
  20.     }
  22.     private void initUI() {
  24.         pnl = (JPanel) getContentPane();
  26.         var warBtn = new JButton("Warning");
  27.         var errBtn = new JButton("Error");
  28.         var queBtn = new JButton("Question");
  29.         var infBtn = new JButton("Information");
  31.         warBtn.addActionListener(event -> JOptionPane.showMessageDialog(pnl,
  32.                 "A deprecated call!", "Warning", JOptionPane.WARNING_MESSAGE));
  34.         errBtn.addActionListener(event -> JOptionPane.showMessageDialog(pnl,
  35.                 "Could not open file!", "Error", JOptionPane.ERROR_MESSAGE));
  37.         queBtn.addActionListener(event -> JOptionPane.showMessageDialog(pnl,
  38.                 "Are you sure to quit?", "Question", JOptionPane.QUESTION_MESSAGE));
  40.         infBtn.addActionListener(event -> JOptionPane.showMessageDialog(pnl,
  41.                 "Download completed.", "Information", 
  42.                 JOptionPane.INFORMATION_MESSAGE));
  44.         createLayout(warBtn, errBtn, queBtn, infBtn);
  46.         setTitle("Message dialogs");
  47.         setSize(300, 200);
  48.         setLocationRelativeTo(null);
  49.         setDefaultCloseOperation(EXIT_ON_CLOSE);
  50.     }
  52.     private void createLayout(JComponent... arg) {
  54.         var pane = getContentPane();
  55.         var gl = new GroupLayout(pane);
  56.         pane.setLayout(gl);
  58.         gl.setAutoCreateGaps(true);
  60.         gl.setHorizontalGroup(gl.createSequentialGroup()
  61.                 .addContainerGap(DEFAULT_SIZE, Short.MAX_VALUE)
  62.                 .addGroup(gl.createParallelGroup()
  63.                         .addComponent(arg[0])
  64.                         .addComponent(arg[2]))
  65.                 .addGroup(gl.createParallelGroup()
  66.                         .addComponent(arg[1])
  67.                         .addComponent(arg[3]))
  68.                 .addContainerGap(DEFAULT_SIZE, Short.MAX_VALUE)
  69.         );
  71.         gl.setVerticalGroup(gl.createSequentialGroup()
  72.                 .addContainerGap(DEFAULT_SIZE, Short.MAX_VALUE)
  73.                 .addGroup(gl.createParallelGroup()
  74.                         .addComponent(arg[0])
  75.                         .addComponent(arg[1]))
  76.                 .addGroup(gl.createParallelGroup()
  77.                         .addComponent(arg[2])
  78.                         .addComponent(arg[3]))
  79.                 .addContainerGap(DEFAULT_SIZE, Short.MAX_VALUE)
  80.         );
  82.         gl.linkSize(arg[0], arg[1], arg[2], arg[3]);
  84.         pack();
  85.     }
  87.     public static void main(String[] args) {
  89.         EventQueue.invokeLater(() -> {
  91.             var md = new MessageDialogsEx();
  92.             md.setVisible(true);
  93.         });
  94.     }
  95. }

该示例显示了错误，警告，问题和信息消息对话框。

  1. var warBtn = new JButton("Warning");
  2. var errBtn = new JButton("Error");
  3. var queBtn = new JButton("Question");
  4. var infBtn = new JButton("Information");

这四个按钮显示四个不同的消息对话框。

  1. errBtn.addActionListener(event -> JOptionPane.showMessageDialog(pnl,
  2.         "Could not open file!", "Error", JOptionPane.ERROR_MESSAGE));

要创建消息对话框，我们调用JOptionPane类的静态showMessageDialog()方法。 我们提供对话框的父项，消息文本，标题和消息类型。 消息类型是以下常量之一：

  • ERROR_MESSAGE
  • WARNING_MESSAGE
  • QUESTION_MESSAGE
  • INFORMATION_MESSAGE

显示的图标取决于此常数。

Java Swing 对话框 - 图1

图：问题消息对话框

自定义对话框

在下面的示例中，我们创建一个简单的自定义对话框。 它是有关在许多 GUI 应用中找到的对话框的示例，通常位于“帮助”菜单中。

CustomDialogEx.java

  1. package com.zetcode;
  3. import javax.swing.Box;
  4. import javax.swing.GroupLayout;
  5. import javax.swing.ImageIcon;
  6. import javax.swing.JButton;
  7. import javax.swing.JComponent;
  8. import javax.swing.JDialog;
  9. import javax.swing.JFrame;
  10. import javax.swing.JLabel;
  11. import javax.swing.JMenu;
  12. import javax.swing.JMenuBar;
  13. import javax.swing.JMenuItem;
  14. import java.awt.EventQueue;
  15. import java.awt.Font;
  16. import java.awt.Frame;
  17. import java.awt.event.ActionEvent;
  18. import java.awt.event.ActionListener;
  19. import java.awt.event.KeyEvent;
  21. import static javax.swing.GroupLayout.Alignment.CENTER;
  23. class AboutDialog extends JDialog {
  25.     public AboutDialog(Frame parent) {
  26.         super(parent);
  28.         initUI();
  29.     }
  31.     private void initUI() {
  33.         var icon = new ImageIcon("src/resources/notes.png");
  34.         var imgLabel = new JLabel(icon);
  36.         var textLabel = new JLabel("Notes, 1.23");
  37.         textLabel.setFont(new Font("Serif", Font.BOLD, 13));
  39.         var okBtn = new JButton("OK");
  40.         okBtn.addActionListener(event -> dispose());
  42.         createLayout(textLabel, imgLabel, okBtn);
  44.         setModalityType(ModalityType.APPLICATION_MODAL);
  46.         setTitle("About Notes");
  47.         setDefaultCloseOperation(DISPOSE_ON_CLOSE);
  48.         setLocationRelativeTo(getParent());
  49.     }
  51.     private void createLayout(JComponent... arg) {
  53.         var pane = getContentPane();
  54.         var gl = new GroupLayout(pane);
  55.         pane.setLayout(gl);
  57.         gl.setAutoCreateContainerGaps(true);
  58.         gl.setAutoCreateGaps(true);
  60.         gl.setHorizontalGroup(gl.createParallelGroup(CENTER)
  61.                 .addComponent(arg[0])
  62.                 .addComponent(arg[1])
  63.                 .addComponent(arg[2])
  64.                 .addGap(200)
  65.         );
  67.         gl.setVerticalGroup(gl.createSequentialGroup()
  68.                 .addGap(30)
  69.                 .addComponent(arg[0])
  70.                 .addGap(20)
  71.                 .addComponent(arg[1])
  72.                 .addGap(20)
  73.                 .addComponent(arg[2])
  74.                 .addGap(30)
  75.         );
  77.         pack();
  78.     }
  79. }
  81. public class CustomDialogEx extends JFrame
  82.         implements ActionListener {
  84.     public CustomDialogEx() {
  86.         initUI();
  87.     }
  89.     private void initUI() {
  91.         createMenuBar();
  93.         setTitle("Simple Dialog");
  94.         setSize(350, 250);
  95.         setLocationRelativeTo(null);
  96.         setDefaultCloseOperation(EXIT_ON_CLOSE);
  97.     }
  99.     private void createMenuBar() {
  101.         var menubar = new JMenuBar();
  103.         var fileMenu = new JMenu("File");
  104.         fileMenu.setMnemonic(KeyEvent.VK_F);
  106.         var helpMenu = new JMenu("Help");
  107.         helpMenu.setMnemonic(KeyEvent.VK_H);
  109.         var aboutMemuItem = new JMenuItem("About");
  110.         aboutMemuItem.setMnemonic(KeyEvent.VK_A);
  111.         helpMenu.add(aboutMemuItem);
  113.         aboutMemuItem.addActionListener(this);
  115.         menubar.add(fileMenu);
  116.         menubar.add(Box.createGlue());
  117.         menubar.add(helpMenu);
  118.         setJMenuBar(menubar);
  119.     }
  121.     @Override
  122.     public void actionPerformed(ActionEvent e) {
  124.         showAboutDialog();
  125.     }
  127.     private void showAboutDialog() {
  129.         var aboutDialog = new AboutDialog(this);
  130.         aboutDialog.setVisible(true);
  131.     }
  133.     public static void main(String[] args) {
  135.         EventQueue.invokeLater(() -> {
  137.             var ex = new CustomDialogEx();
  138.             ex.setVisible(true);
  139.         });
  140.     }
  141. }

从“帮助”菜单中，我们可以弹出一个小对话框。 该对话框显示文本，图标和按钮。

  1. class AboutDialog extends JDialog {

自定义对话框基于JDialog类。

  1. setModalityType(ModalityType.APPLICATION_MODAL);

setModalityType()方法设置对话框的模态类型。 ModalityType.APPLICATION_MODAL阻止来自同一应用的所有顶级窗口的输入。 在我们的例子中，在对话框的生存期内，应用框架的输入被阻止。

  1. setLocationRelativeTo(getParent());

setLocationRelativeTo()方法将对话框窗口居中在框架窗口的区域上方。

  1. setDefaultCloseOperation(DISPOSE_ON_CLOSE);

setDefaultCloseOperation()设置用户单击窗口的“关闭”按钮时发生的情况。 该对话框将被隐藏和处置。

  1. private void showAboutDialog() {
  3.     var aboutDialog = new AboutDialog(this);
  4.     aboutDialog.setVisible(true);
  5. }

对话框窗口使用setVisible()方法显示在屏幕上。

Java Swing 对话框 - 图2

图：自定义对话框

JFileChooser

JFileChooser是用于从文件系统中选择文件的标准对话框。

FileChooserEx.java

  1. package com.zetcode;
  3. import javax.swing.AbstractAction;
  4. import javax.swing.GroupLayout;
  5. import javax.swing.ImageIcon;
  6. import javax.swing.JButton;
  7. import javax.swing.JComponent;
  8. import javax.swing.JFileChooser;
  9. import javax.swing.JFrame;
  10. import javax.swing.JOptionPane;
  11. import javax.swing.JPanel;
  12. import javax.swing.JScrollPane;
  13. import javax.swing.JTextArea;
  14. import javax.swing.JToolBar;
  15. import javax.swing.filechooser.FileNameExtensionFilter;
  16. import java.awt.EventQueue;
  17. import java.awt.event.ActionEvent;
  18. import java.io.File;
  19. import java.io.IOException;
  20. import java.nio.file.Files;
  21. import java.nio.file.Paths;
  23. import static javax.swing.GroupLayout.DEFAULT_SIZE;
  25. public class FileChooserEx extends JFrame {
  27.     private JPanel panel;
  28.     private JTextArea area;
  30.     public FileChooserEx() {
  32.         initUI();
  33.     }
  35.     private void initUI() {
  37.         panel = (JPanel) getContentPane();
  38.         area = new JTextArea();
  40.         var spane = new JScrollPane();
  41.         spane.getViewport().add(area);
  43.         var toolbar = createToolBar();
  45.         createLayout(toolbar, spane);
  47.         setTitle("JFileChooser");
  48.         setSize(400, 300);
  49.         setLocationRelativeTo(null);
  50.         setDefaultCloseOperation(EXIT_ON_CLOSE);
  51.     }
  53.     private JToolBar createToolBar() {
  55.         var openIcon = new ImageIcon("src/resources/document-open.png");
  57.         var toolbar = new JToolBar();
  58.         var openBtn = new JButton(openIcon);
  60.         openBtn.addActionListener(new OpenFileAction());
  62.         toolbar.add(openBtn);
  64.         return toolbar;
  65.     }
  67.     private void createLayout(JComponent... arg) {
  69.         var pane = getContentPane();
  70.         var gl = new GroupLayout(pane);
  71.         pane.setLayout(gl);
  73.         gl.setHorizontalGroup(gl.createParallelGroup()
  74.                 .addComponent(arg[0], DEFAULT_SIZE, DEFAULT_SIZE,
  75.                         Short.MAX_VALUE)
  76.                 .addGroup(gl.createSequentialGroup()
  77.                         .addComponent(arg[1]))
  78.         );
  80.         gl.setVerticalGroup(gl.createSequentialGroup()
  81.                 .addComponent(arg[0])
  82.                 .addGap(4)
  83.                 .addComponent(arg[1])
  84.         );
  86.         pack();
  87.     }
  89.     public String readFile(File file) {
  91.         String content = "";
  93.         try {
  94.             content = new String(Files.readAllBytes(Paths.get(
  95.                     file.getAbsolutePath())));
  96.         } catch (IOException ex) {
  97.             JOptionPane.showMessageDialog(this,
  98.                     "Could not read file", "Error", JOptionPane.ERROR_MESSAGE);
  99.         }
  101.         return content;
  102.     }
  104.     private class OpenFileAction extends AbstractAction {
  106.         @Override
  107.         public void actionPerformed(ActionEvent e) {
  109.             var fileChooser = new JFileChooser();
  110.             var filter = new FileNameExtensionFilter("Java files", "java");
  111.             fileChooser.addChoosableFileFilter(filter);
  113.             int ret = fileChooser.showDialog(panel, "Open file");
  115.             if (ret == JFileChooser.APPROVE_OPTION) {
  117.                 var file = fileChooser.getSelectedFile();
  118.                 var text = readFile(file);
  120.                 area.setText(text);
  121.             }
  122.         }
  123.     }
  125.     public static void main(String[] args) {
  127.         EventQueue.invokeLater(() -> {
  129.             var ex = new FileChooserEx();
  130.             ex.setVisible(true);
  131.         });
  132.     }
  133. }

该代码示例将演示如何使用JFileChooser将文件内容加载到文本区域组件中。

  1. var fileChooser = new JFileChooser();

这是文件选择器对话框的构造器。

  1. var filter = new FileNameExtensionFilter("Java files", "java");
  2. fileChooser.addChoosableFileFilter(filter);

在这里，我们定义文件过滤器。 在本例中，我们将具有扩展名为.java的 Java 文件。 我们还有默认的“所有文件”选项。

  1. int ret = fileChooser.showDialog(panel, "Open file");

showDialog()方法在屏幕上显示对话框。 单击“是”或“确定”按钮时，将返回JFileChooser.APPROVE_OPTION。

  1. if (ret == JFileChooser.APPROVE_OPTION) {
  3.     var file = fileChooser.getSelectedFile();
  4.     var text = readFile(file);
  6.     area.setText(text);
  7. }

在这里，我们获得所选文件的名称。 我们读取文件的内容并将文本设置到文本区域中。

Java Swing 对话框 - 图3

图：JFileChooser对话框

JColorChooser

JColorChooser是用于选择颜色的标准对话框。

ColorChooserEx.java

  1. package com.zetcode;
  3. import javax.swing.GroupLayout;
  4. import javax.swing.ImageIcon;
  5. import javax.swing.JButton;
  6. import javax.swing.JColorChooser;
  7. import javax.swing.JComponent;
  8. import javax.swing.JFrame;
  9. import javax.swing.JPanel;
  10. import javax.swing.JToolBar;
  11. import java.awt.Color;
  12. import java.awt.EventQueue;
  14. import static javax.swing.GroupLayout.DEFAULT_SIZE;
  16. public class ColorChooserEx extends JFrame {
  18.     private JPanel colourPanel;
  20.     public ColorChooserEx() {
  22.         initUI();
  23.     }
  25.     private void initUI() {
  27.         colourPanel = new JPanel();
  28.         colourPanel.setBackground(Color.WHITE);
  30.         var toolbar = createToolBar();
  32.         createLayout(toolbar, colourPanel);
  34.         setTitle("JColorChooser");
  35.         setSize(400, 300);
  36.         setLocationRelativeTo(null);
  37.         setDefaultCloseOperation(EXIT_ON_CLOSE);
  38.     }
  40.     private JToolBar createToolBar() {
  42.         var openIcon = new ImageIcon("src/resources/colourdlg.png");
  44.         var toolbar = new JToolBar();
  45.         var openBtn = new JButton(openIcon);
  47.         openBtn.addActionListener(e -> {
  49.             var color = JColorChooser.showDialog(colourPanel,
  50.                     "Choose colour", Color.white);
  51.             colourPanel.setBackground(color);
  52.         });
  54.         toolbar.add(openBtn);
  56.         return toolbar;
  57.     }
  59.     private void createLayout(JComponent... arg) {
  61.         var pane = getContentPane();
  62.         var gl = new GroupLayout(pane);
  63.         pane.setLayout(gl);
  65.         gl.setHorizontalGroup(gl.createParallelGroup()
  66.                 .addComponent(arg[0], DEFAULT_SIZE, DEFAULT_SIZE,
  67.                         Short.MAX_VALUE)
  68.                 .addGroup(gl.createSequentialGroup()
  69.                         .addGap(30)
  70.                         .addComponent(arg[1])
  71.                         .addGap(30))
  72.         );
  74.         gl.setVerticalGroup(gl.createSequentialGroup()
  75.                 .addComponent(arg[0])
  76.                 .addGap(30)
  77.                 .addComponent(arg[1])
  78.                 .addGap(30)
  79.         );
  81.         pack();
  82.     }
  84.     public static void main(String[] args) {
  86.         EventQueue.invokeLater(() -> {
  88.             var ex = new ColorChooserEx();
  89.             ex.setVisible(true);
  90.         });
  91.     }
  92. }

在示例中，我们有一个白色面板。 我们将通过从JColorChooser中选择一种颜色来更改面板的背景颜色。

  1. var color = JColorChooser.showDialog(colourPanel,
  2.         "Choose colour", Color.white);
  3. colourPanel.setBackground(color);

此代码显示颜色选择器对话框。 showDialog()方法返回所选的颜色值。 我们将colourPanel's背景更改为新选择的颜色。

在 Java Swing 教程的这一部分中，我们介绍了对话框。