初期値を設定した入力ダイアログを表示する

入力ダイアログでテキストボックスに表示される初期値を指定して入力ダイアログを表示する方法を確認します。JOptionPaneクラスで用意されている「showInputDialog」メソッドを使います。前頁の同名のメソッドとは引数が異なります。

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

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

パラメータ:
  parentComponent - ダイアログの親 Component
  message - 表示する Object
  initialSelectionValue - 入力フィールドを初期化する値

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

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

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

3番目の引数にはテキストボックスに初期値として表示する値をString型の値で指定します。

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

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

JFrame frame = new JFrame();

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

サンプルプログラム

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

JOptionPaneTest10.java

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

public class JOptionPaneTest10 extends JFrame implements ActionListener{

  JLabel ansLabel;

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

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

  JOptionPaneTest10(){
    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);
    }
  }
}

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

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

今回はテキストボックスに初期値が入力された状態で表示されます。