1. 概述

官方JavaDocsApi:

JDialog，對話方塊。使用 JDialog 類可以建立自定義有的對話方塊，或者呼叫 JOptionPane 中的多個靜態方法快速建立各種標準的對話方塊。

JOptionPane是 JavaSwing 內部已實現好的，以靜態方法的形式提供呼叫，能夠快速方便的彈出要求使用者提供值或向其發出通知的標準對話方塊。

JOptionPane 提供的 標準對話方塊 型別分為以下幾種:

這些標準對話方塊的基本外形佈局通常如下圖所示:

上述四個型別的方法（包括其若干過載）的引數遵循一致的模式，下面介紹各引數的含義:

(1) parentComponent: 對話方塊的父級元件，決定對話方塊顯示的位置，對話方塊的顯示會盡量緊靠元件的中心，如果傳 null，則顯示在螢幕的中心。

(2) title: 對話方塊標題。

(3) message

(4) messageType: 訊息型別，主要是提供預設的對話方塊圖示。可能的值為：

• JOptionPane.PLAIN_MESSAGE 簡單訊息（不使用圖示）
• JOptionPane.INFORMATION_MESSAGE 資訊訊息（預設）
• JOptionPane.QUESTION_MESSAGE 問題訊息
• JOptionPane.WARNING_MESSAGE 警告訊息
• JOptionPane.ERROR_MESSAGE 錯誤訊息

(5) icon: 自定義的對話方塊圖示，如果傳 null，則圖示型別由 messageType 決定。

(6) optionType

(7) options、initialValue: 自定義的選項按鈕（如果穿 null，則選項按鈕由 optionType 決定），以及預設選中的選項按鈕。

(8) selectionValues、initialSelectionValue: 提供的輸入選項，以及預設選中的選項。

下面是 JOptionPane 類中各標準對話方塊的靜態方法過載:

訊息對話方塊:

static void showMessageDialog(Component parentComponent, 
                              Object message)

static void showMessageDialog(Component parentComponent, 
                              Object message, 
                              String title, 
                              int messageType)

static void showMessageDialog(Component parentComponent, 
                              Object message, 
                              String title, 
                              int messageType, 
                              Icon icon)

確認對話方塊:

static int showConfirmDialog(Component parentComponent, 
                             Object message)

static int showConfirmDialog(Component parentComponent, 
                             Object message, 
                             String title, 
                             int optionType)

static int showConfirmDialog(Component parentComponent, 
                             Object message, 
                             String title, 
                             int optionType, 
                             int messageType)

static int showConfirmDialog(Component parentComponent, 
                             Object message, 
                             String title, 
                             int optionType, 
                             int messageType, 
                             Icon icon)

輸入對話方塊:

static String showInputDialog(Component parentComponent, 
                              Object message)

static String showInputDialog(Component parentComponent, 
                              Object message, 
                              Object initialSelectionValue)

static String showInputDialog(Component parentComponent, 
                              Object message, 
                              String title, 
                              int messageType)

static Object showInputDialog(Component parentComponent, 
                              Object message, 
                              String title, 
                              int messageType, 
                              Icon icon, 
                              Object[] selectionValues, 
                              Object initialSelectionValue)

選項對話方塊:

static int showOptionDialog(Component parentComponent, 
                            Object message, 
                            String title, 
                            int optionType, 
                            int messageType, 
                            Icon icon, 
                            Object[] options, 
                            Object initialValue)

2. 程式碼例項: 標準對話方塊的顯示（JOptionPane）

package com.xiets.swing;

import javax.swing.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

public class Main {

    public static void main(String[] args) throws Exception {
        final JFrame jf = new JFrame("測試視窗");
        jf.setSize(400, 400);
        jf.setLocationRelativeTo(null);
        jf.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);

        /*
         * 1. 訊息對話方塊（資訊訊息）
         */
        JButton btn01 = new JButton("showMessageDialog（資訊訊息）");
        btn01.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                // 訊息對話方塊無返回, 僅做通知作用
                JOptionPane.showMessageDialog(
                        jf,
                        "Hello Information Message",
                        "訊息標題",
                        JOptionPane.INFORMATION_MESSAGE
                );
            }
        });

        /*
         * 2. 訊息對話方塊（警告訊息）
         */
        JButton btn02 = new JButton("showMessageDialog（警告訊息）");
        btn02.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                // 訊息對話方塊無返回, 僅做通知作用
                JOptionPane.showMessageDialog(
                        jf,
                        "Hello Warning Message",
                        "訊息標題",
                        JOptionPane.WARNING_MESSAGE
                );
            }
        });

        /*
         * 3. 確認對話方塊
         */
        JButton btn03 = new JButton("showConfirmDialog");
        btn03.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                /*
                 * 返回使用者點選的選項, 值為下面三者之一:
                 *     是:   JOptionPane.YES_OPTION
                 *     否:   JOptionPane.NO_OPTION
                 *     取消: JOptionPane.CANCEL_OPTION
                 *     關閉: JOptionPane.CLOSED_OPTION
                 */
                int result = JOptionPane.showConfirmDialog(
                        jf,
                        "確認刪除？",
                        "提示",
                        JOptionPane.YES_NO_CANCEL_OPTION
                );
                System.out.println("選擇結果: " + result);
            }
        });

        /*
         * 4. 輸入對話方塊（文字框輸入）
         */
        JButton btn04 = new JButton("showInputDialog（文字框輸入）");
        btn04.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                // 顯示輸入對話方塊, 返回輸入的內容
                String inputContent = JOptionPane.showInputDialog(
                        jf,
                        "輸入你的名字:",
                        "預設內容"
                );
                System.out.println("輸入的內容: " + inputContent);
            }
        });

        /*
         * 5. 輸入對話方塊（下拉框選擇）
         */
        JButton btn05 = new JButton("showInputDialog（下拉框選擇）");
        btn05.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                Object[] selectionValues = new Object[]{"香蕉", "雪梨", "蘋果"};

                // 顯示輸入對話方塊, 返回選擇的內容, 點選取消或關閉, 則返回null
                Object inputContent = JOptionPane.showInputDialog(
                        jf,
                        "選擇一項: ",
                        "標題",
                        JOptionPane.PLAIN_MESSAGE,
                        null,
                        selectionValues,
                        selectionValues[0]
                );
                System.out.println("輸入的內容: " + inputContent);
            }
        });

        /*
         * 6. 選項對話方塊
         */
        JButton btn06 = new JButton("showOptionDialog");
        btn06.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                // 選項按鈕
                Object[] options = new Object[]{"香蕉", "雪梨", "蘋果"};

                // 顯示選項對話方塊, 返回選擇的選項索引, 點選關閉按鈕返回-1
                int optionSelected = JOptionPane.showOptionDialog(
                        jf,
                        "請點選一個按鈕選擇一項",
                        "對話方塊標題",
                        JOptionPane.YES_NO_CANCEL_OPTION,
                        JOptionPane.ERROR_MESSAGE,
                        null,
                        options,    // 如果傳null, 則按鈕為 optionType 型別所表示的按鈕（也就是確認對話方塊）
                        options[0]
                );

                if (optionSelected >= 0) {
                    System.out.println("點選的按鈕: " + options[optionSelected]);
                }
            }
        });

        // 垂直排列按鈕
        Box vBox = Box.createVerticalBox();
        vBox.add(btn01);
        vBox.add(btn02);
        vBox.add(btn03);
        vBox.add(btn04);
        vBox.add(btn05);
        vBox.add(btn06);

        JPanel panel = new JPanel();
        panel.add(vBox);

        jf.setContentPane(panel);
        jf.setVisible(true);
    }

}

3. 程式碼例項: 自定義對話方塊的顯示（JDialog）

對話方塊 JDialog 和 JFrame 都是繼承自 java.awt.Window，用法與 JFrame 類似。

對話方塊分為 模態 和 非模態:

• 模態: 彈出對話方塊後，對話方塊的父級視窗不可操作。
• 非模態: 彈出對話方塊後，對話方塊的父級視窗可以正常操作。

對話方塊不能最小化。

package com.xiets.swing;

import javax.swing.*;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

public class Main {

    public static void main(String[] args) throws Exception {
        final JFrame jf = new JFrame("測試視窗");
        jf.setSize(300, 300);
        jf.setLocationRelativeTo(null);
        jf.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);

        JButton btn = new JButton("顯示自定義對話方塊");
        btn.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                showCustomDialog(jf, jf);
            }
        });

        JPanel panel = new JPanel();
        panel.add(btn);

        jf.setContentPane(panel);
        jf.setVisible(true);
    }

    /**
     * 顯示一個自定義的對話方塊
     *
     * @param owner 對話方塊的擁有者
     * @param parentComponent 對話方塊的父級元件
     */
    private static void showCustomDialog(Frame owner, Component parentComponent) {
        // 建立一個模態對話方塊
        final JDialog dialog = new JDialog(owner, "提示", true);
        // 設定對話方塊的寬高
        dialog.setSize(250, 150);
        // 設定對話方塊大小不可改變
        dialog.setResizable(false);
        // 設定對話方塊相對顯示的位置
        dialog.setLocationRelativeTo(parentComponent);

        // 建立一個標籤顯示訊息內容
        JLabel messageLabel = new JLabel("對話方塊訊息內容");

        // 建立一個按鈕用於關閉對話方塊
        JButton okBtn = new JButton("確定");
        okBtn.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                // 關閉對話方塊
                dialog.dispose();
            }
        });

        // 建立對話方塊的內容面板, 在面板內可以根據自己的需要新增任何元件並做任意是佈局
        JPanel panel = new JPanel();

        // 新增元件到面板
        panel.add(messageLabel);
        panel.add(okBtn);

        // 設定對話方塊的內容面板
        dialog.setContentPane(panel);
        // 顯示對話方塊
        dialog.setVisible(true);
    }

}