入力ダイアログを表示する

入力ダイアログはテキストボックスを表示してユーザーに値を入力してもらうためのダイアログです。入力ダイアログを表示するためにはJOptionPaneクラスで用意されている「showInputDialog」メソッドを使います。

showInputDialog
public static String showInputDialog(Component parentComponent,
                                     Object message)
                              throws HeadlessException

parentComponent を親として、ユーザーに入力を求めるクエスチョンメッセー
ジダイアログを表示します。ダイアログは、Component のフレームの上に表示
され、通常は Component の下に配置されます。

パラメータ:
  parentComponent - ダイアログの親 Component
  message - 表示する Object 
例外: 
  HeadlessException - GraphicsEnvironment.isHeadless が true を返す場合

このメソッドを使うとテキストボックスが1つと「了解」「取消し」の2つボタンがが表示される入力ダイアログを表示できます。

1番目の引数にダイアログを表示するための親フレームを指定します。例えばJFrameクラスのオブジェクトを指定して下さい。

2番目の引数にはダイアログに表示するオブジェクトを指定します。単に文字列を表示するだけであればString型の値を指定すればいいですし、JLabelクラスなどのオブジェクトを指定しても構いません。

戻り値としてユーザーが入力した値を表すString型の値を取得できます。なお、「取消し」ボタンがクリックされた場合は「null」が帰ってきます。

実際の使い方は次のようになります。

JFrame frame = new JFrame();

String value = JOptionPane.showInputDialog(frame, "Message");

サンプルプログラム

では簡単なサンプルを作成して試してみます。

JOptionPaneTest9.java

import javax.swing.*;
import java.awt.BorderLayout;
import java.awt.event.*;

public class JOptionPaneTest9 extends JFrame implements ActionListener{

  JLabel ansLabel;

  public static void main(String[] args){
    JOptionPaneTest9 frame = new JOptionPaneTest9();

    frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
    frame.setBounds(10, 10, 300, 200);
    frame.setTitle("タイトル");
    frame.setVisible(true);
  }

  JOptionPaneTest9(){
    JButton infoButton = new JButton("Question");
    infoButton.addActionListener(this);

    JPanel p = new JPanel();
    p.add(infoButton);

    ansLabel = new JLabel("未入力です");
    JPanel ansPanel = new JPanel();
    ansPanel.add(ansLabel);

    getContentPane().add(p, BorderLayout.CENTER);
    getContentPane().add(ansPanel, BorderLayout.PAGE_END);
  }

  public void actionPerformed(ActionEvent e){
    String value = JOptionPane.showInputDialog(this, "お名前は？");

    if (value == null){
      ansLabel.setText("取消されました");
    }else{
      ansLabel.setText(value);
    }
  }
}

上記をコンパイルした後で実行すると次のように表示されます。

ボタンをクリックすると入力ダイアログが表示されます。

表示されたテキストボックスに文字列を入力してから「了解」ボタンをクリックして下さい。元のフレームの画面下のラベルが入力された値に書き換えられます。

入力ダイアログが表示されている時に「取消し」ボタンをクリックするとダイアログからの戻り値として「null」が返され、今回のサンプルでは次のように表示されます。