|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JOptionPane
JOptionPane は、ユーザに値の入力を求めたり情報を提示したりする標準的なダイアログボックスを簡単に表示できるようにします。メソッド数が多いために複雑そうに見えますが、このクラスは、以下に示すどれかの static な showXxxDialog
メソッドの片方向の呼び出し以外はほとんど使用しません。
以上の 3 つの各メソッドは、内部フレームを使用してダイアログボックスを保持する
showConfirmDialog はい/いいえ/キャンセル等の確認の要求 showInputDialog 入力プロンプト showMessageDialog ユーザへのメッセージ showOptionDialog 以上の 3 つを合わせたもの
showInternalXXX
フレーバーの特長を備えています (JInternalFrame
を参照)。異なるパラメータリストを使用する基本メソッドをオーバーロードしたバージョン等、いくつかの簡易メソッドも定義されています。
すべてのダイアログはモーダルです。各 showXxxDialog
メソッドは、ユーザの対話が終了するまで現在のスレッドをブロックします。
アイコン | メッセージ |
入力値 | |
オプションボタン |
パラメータ:
これらのメソッドに対するパラメータは一貫性のあるパターンになります。
- parentComponent
- このダイアログボックスの親となる Component を定義します。使用方法は 2 つあります。ダイアログボックスを格納する Frame はダイアログボックスの親 Frame として使用されます。画面座標はダイアログボックスの配置に使用されます。通常は、ダイアログボックスはコンポーネントのすぐ下に配置されます。このパラメータが null の場合、親としてデフォルトの Frame が使用され、ダイアログは L&F に応じて画面の中央に配置されます。
- message
- ダイアログボックスに表示する説明メッセージです。一般的には、メッセージは単純な String または String 定数です。ただし、このパラメータの型は実際には Object です。解釈は型によって異なります。
- Object[]
- オブジェクトの配列は、垂直スタック状に配列された一連のメッセージ (1 オブジェクトについて 1 メッセージ) として解釈されます。解釈は再帰的に行われます。配列内の各オブジェクトはその型に応じて解釈されます。
- Component
- Component はダイアログに表示されます。
- Icon
- アイコンは JLabel にラップされてダイアログに表示されます。
- それ以外
- オブジェクトは、その
toString
メソッド呼び出しにより String に変換されます。結果は JLabel にラップされて表示されます。- messageType
- メッセージの書式を定義します。Look & Feel マネージャは、この値に応じてダイアログを個別にレイアウトし、通常はデフォルトのアイコンを用意します。使用可能な値は以下のとおりです。
- ERROR_MESSAGE
- INFORMATION_MESSAGE
- WARNING_MESSAGE
- QUESTION_MESSAGE
- PLAIN_MESSAGE
- optionType
- ダイアログボックスの下部に表示されるオプションボタンのセットを定義します。
使用できるのはこれらのオプションボタンに限りません。オプションのパラメータを使用して任意のボタンを指定することができます。
- DEFAULT_OPTION
- YES_NO_OPTION
- YES_NO_CANCEL_OPTION
- OK_CANCEL_OPTION
- options
- ダイアログボックスの下に表示されるオプションボタンの詳細な説明です。オプションパラメータは通常は String 配列です。ただし、パラメータ型は Object 配列です。ボタンはその型に応じて各オブジェクトについて作成されます。
- Component
- コンポーネントはボタンの並びに直接追加されます。
- Icon
- これをラベルとして JButton が生成されます。
- それ以外
- Object は、その
toString
メソッドで文字列に変換され、その結果文字列は JButton のラベルとして使用されます。- icon
- ダイアログボックスに配置される装飾アイコンです。デフォルト値は messageType パラメータで決まります。
- title
- ダイアログボックスのタイトルです。
- initialValue
- デフォルトの選択 (入力値) です。
選択が変更されると、setValue
が起動され、PropertyChangeEvent が生成されます。
JOptionPane がすべて入力 setWantsInput
に設定されている場合、バウンドプロパティの JOptionPane.INPUT_VALUE_PROPERTY を待機することによっても、ユーザが値を入力または選択した時点を判定することができます。
showXxxDialog
メソッドの 1 つが整数を返した場合、その値は以下のどれかになります。
YES_OPTION, NO_OPTION, CANCEL_OPTION, OK_OPTION, CLOSED_OPTION.例:
JOptionPane.showMessageDialog(null, "alert", "alert", ERROR_MESSAGE);
JOptionPane.showInternalMessageDialog(frame, INFORMATION_MESSAGE,
"information", "information");
JOptionPane.showConfirmDialog(null,
"choose one", "choose one", YES_NO_OPTION);
JOptionPane.showInternalConfirmDialog(frame,
"please choose one", "information",
YES_NO_CANCEL_OPTION, INFORMATION_MESSAGE);
Object[] options = { "OK", "CANCEL" };
JOptionPane.showOptionDialog(null, "Click OK to continue", "Warning",
DEFAULT_OPTION, WARNING_MESSAGE,
null, options, options[0]);
String inputValue = JOptionPane.showInputDialog("Please input a value");
Object[] possibleValues = { "First", "Second", "Third" };
Object selectedValue = JOptionPane.showInputDialog(null,
"Choose one", "Input",
JOptionPane.INFORMATION_MESSAGE, null,
possibleValues, possibleValues[0]);
JOptionPane pane = new JOptionPane(arguments); pane.set.Xxxx(...); // Configure JDialog dialog = pane.createDialog(parentComponent, title); dialog.show(); Object selectedValue = pane.getValue(); if(selectedValue == null) return CLOSED_OPTION; //If there is not an array of option buttons: if(options == null) { if(selectedValue instanceof Integer) return ((Integer)selectedValue).intValue(); return CLOSED_OPTION; } //If there is an array of option buttons: for(int counter = 0, maxCounter = options.length; counter < maxCounter; counter++) { if(options[counter].equals(selectedValue)) return counter; } return CLOSED_OPTION;
標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JOptionPane のキーの割り当てを参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。
JInternalFrame
, 直列化された形式内部クラスの概要 | |
protected class |
JOptionPane.AccessibleJOptionPane
ユーザ補助機能をサポートします。 |
クラス javax.swing.JComponent から継承した内部クラス |
JComponent.AccessibleJComponent |
フィールドの概要 | |
static int |
CANCEL_OPTION
「CANCEL」が選択された場合にクラスメソッドから返される値です。 |
static int |
CLOSED_OPTION
ユーザが何も選択せずにウィンドウを閉じた場合にクラスメソッドから返される値です。 |
static int |
DEFAULT_OPTION
Look & Feel を意味する型はオプションを提供しません。 |
static int |
ERROR_MESSAGE
エラーメッセージで使用します。 |
protected Icon |
icon
区画で使用されるアイコンです。 |
static String |
ICON_PROPERTY
アイコンのバウンドプロパティ名です。 |
static int |
INFORMATION_MESSAGE
情報メッセージで使用します。 |
static String |
INITIAL_SELECTION_VALUE_PROPERTY
initialSelectionValue のバウンドプロパティ名です。 |
static String |
INITIAL_VALUE_PROPERTY
initialValue のバウンドプロパティ名です。 |
protected Object |
initialSelectionValue
selectionValues で選択する初期値です。 |
protected Object |
initialValue
オプションで初期状態で選択される値です。 |
static String |
INPUT_VALUE_PROPERTY
inputValue のバウンドプロパティ名です。 |
protected Object |
inputValue
ユーザが入力した値です。 |
protected Object |
message
表示するメッセージです。 |
static String |
MESSAGE_PROPERTY
メッセージのバウンドプロパティ名です。 |
static String |
MESSAGE_TYPE_PROPERTY
型のバウンドプロパティ名です。 |
protected int |
messageType
メッセージのタイプです。 |
static int |
NO_OPTION
「NO」が選択された場合にクラスメソッドから返される値です。 |
static int |
OK_CANCEL_OPTION
showConfirmDialog で使用される型です。 |
static int |
OK_OPTION
「OK」が選択された場合にクラスメソッドから返される値です。 |
static String |
OPTION_TYPE_PROPERTY
optionType のバウンドプロパティ名です。 |
protected Object[] |
options
ユーザに表示するオプションです。 |
static String |
OPTIONS_PROPERTY
オプションのバウンドプロパティ名です。 |
protected int |
optionType
DEFAULT_OPTION、YES_NO_OPTION、YES_NO_CANCEL_OPTION、または OK_CANCEL_OPTION のどれかのオプションのタイプです。 |
static int |
PLAIN_MESSAGE
アイコンは使用しません。 |
static int |
QUESTION_MESSAGE
質問で使用します。 |
static String |
SELECTION_VALUES_PROPERTY
selectionValues のバウンドプロパティ名です。 |
protected Object[] |
selectionValues
ユーザが選択可能な値の配列です。 |
static Object |
UNINITIALIZED_VALUE
ユーザがまだ値を選択していないことを示します。 |
protected Object |
value
現在選択されている値です。 |
static String |
VALUE_PROPERTY
値のバウンドプロパティ名です。 |
static String |
WANTS_INPUT_PROPERTY
wantsInput のバウンドプロパティ名です。 |
protected boolean |
wantsInput
true の場合、ユーザには入力を行うための UI ウィジェットが表示されます。 |
static int |
WARNING_MESSAGE
警告メッセージで使用します。 |
static int |
YES_NO_CANCEL_OPTION
showConfirmDialog で使用される型です。 |
static int |
YES_NO_OPTION
showConfirmDialog で使用される型です。 |
static int |
YES_OPTION
「YES」が選択された場合にクラスメソッドから返される値です。 |
クラス javax.swing.JComponent から継承したフィールド |
accessibleContext,
listenerList,
TOOL_TIP_TEXT_KEY,
ui,
UNDEFINED_CONDITION,
WHEN_ANCESTOR_OF_FOCUSED_COMPONENT,
WHEN_FOCUSED,
WHEN_IN_FOCUSED_WINDOW |
クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT,
CENTER_ALIGNMENT,
LEFT_ALIGNMENT,
RIGHT_ALIGNMENT,
TOP_ALIGNMENT |
コンストラクタの概要 | |
JOptionPane()
テストメッセージを含む JOptionPane を生成します。 |
|
JOptionPane(Object message)
UI の提供するプレーンメッセージタイプおよびデフォルトのオプションを使用して、メッセージを表示するための JOptionPane のインスタンスを生成します。 |
|
JOptionPane(Object message,
int messageType)
指定されたメッセージタイプおよびデフォルトのオプションを使用して、メッセージを表示するための JOptionPane のインスタンスを生成します。 |
|
JOptionPane(Object message,
int messageType,
int optionType)
指定されたメッセージタイプおよびオプションを使用して、メッセージを表示するための JOptionPane のインスタンスを生成します。 |
|
JOptionPane(Object message,
int messageType,
int optionType,
Icon icon)
指定されたメッセージタイプ、オプション、およびアイコンを使用して、メッセージを表示するための JOptionPane のインスタンスを生成します。 |
|
JOptionPane(Object message,
int messageType,
int optionType,
Icon icon,
Object[] options)
指定されたメッセージタイプ、アイコン、およびオプションを使用して、メッセージを表示するための JOptionPane のインスタンスを生成します。 |
|
JOptionPane(Object message,
int messageType,
int optionType,
Icon icon,
Object[] options,
Object initialValue)
指定されたメッセージタイプ、アイコン、オプション、および指定の初期状態で選択されているオプションで、メッセージを表示するための JOptionPane のインスタンスを生成します。 |
メソッドの概要 | |
JDialog |
createDialog(Component parentComponent,
String title)
parentComponent のフレーム内の parentComponent の中央に this をラップして新しい JDialog を生成して返します。 |
JInternalFrame |
createInternalFrame(Component parentComponent,
String title)
JInternalFrame のインスタンスを生成して返します。 |
AccessibleContext |
getAccessibleContext()
この JComponent に関連付けられている AccessibleContext を取得します。 |
static JDesktopPane |
getDesktopPaneForComponent(Component parentComponent)
指定されたコンポーネントのデスクトップ区画を返します。 |
static Frame |
getFrameForComponent(Component parentComponent)
指定されたコンポーネントの Frame を返します。 |
Icon |
getIcon()
この区画が表示するアイコンを返します。 |
Object |
getInitialSelectionValue()
初期選択値を返します。 |
Object |
getInitialValue()
初期値を返します。 |
Object |
getInputValue()
wantsInput が true の場合に、ユーザが入力した数値を返します |
int |
getMaxCharactersPerLineCount()
メッセージの 1 行に格納する最大文字数を返します。 |
Object |
getMessage()
この区画が表示するメッセージオブジェクトを返します。 |
int |
getMessageType()
メッセージタイプを返します。 |
Object[] |
getOptions()
ユーザが作成可能な項目を返します。 |
int |
getOptionType()
表示されるオプションのタイプを返します。 |
static Frame |
getRootFrame()
フレームが提供されないクラスメソッドで使用するフレームを返します。 |
Object[] |
getSelectionValues()
選択値を返します。 |
OptionPaneUI |
getUI()
このコンポーネントの L&F を実装する UI オブジェクトを返します。 |
String |
getUIClassID()
このコンポーネントの L&F を実装する UI クラス名を返します。 |
Object |
getValue()
ユーザが選択した値を返します。 |
boolean |
getWantsInput()
parentComponent がユーザの入力に提供される場合に true を返します。 |
protected String |
paramString()
この JOptionPane の文字列表現を返します。 |
void |
selectInitialValue()
初期値を選択するように要求します。 |
void |
setIcon(Icon newIcon)
表示するアイコンを設定します。 |
void |
setInitialSelectionValue(Object newValue)
初期選択値を設定します。 |
void |
setInitialValue(Object newInitialValue)
有効にすべき初期値を設定します。 |
void |
setInputValue(Object newValue)
ユーザの入力値を設定します。 |
void |
setMessage(Object newMessage)
オプション区画のメッセージオブジェクトを設定します。 |
void |
setMessageType(int newType)
オプション区画のメッセージタイプを設定します。 |
void |
setOptions(Object[] newOptions)
この区画が表示するオプションを設定します。 |
void |
setOptionType(int newType)
表示するオプションを設定します。 |
static void |
setRootFrame(Frame newRootFrame)
フレームが提供されないクラスメソッドで使用するフレームを設定します。 |
void |
setSelectionValues(Object[] newValues)
ユーザに選択項目リストを提示する区画のために選択値を設定します。 |
void |
setUI(OptionPaneUI ui)
このコンポーネントの L&F を実装する UI オブジェクトを設定します。 |
void |
setValue(Object newValue)
ユーザが選択した値を設定します。 |
void |
setWantsInput(boolean newValue)
newValue が true の場合は、ユーザが数値を入力できるように parentComponent が提供されます。 |
static int |
showConfirmDialog(Component parentComponent,
Object message)
オプションが「Yes」、「No」、および「Cancel」でタイトルが「Select an Option」の、モーダルダイアログを表示します。 |
static int |
showConfirmDialog(Component parentComponent,
Object message,
String title,
int optionType)
optionType パラメータで選択項目数が決まるモーダルダイアログを表示します。 |
static int |
showConfirmDialog(Component parentComponent,
Object message,
String title,
int optionType,
int messageType)
optionType パラメータで選択項目数が決まるモーダルダイアログを表示します。 |
static int |
showConfirmDialog(Component parentComponent,
Object message,
String title,
int optionType,
int messageType,
Icon icon)
指定されたアイコンを持つモーダルダイアログを表示します。 |
static String |
showInputDialog(Component parentComponent,
Object message)
parentComponent を親として、ユーザに入力を求めるクエスチョンメッセージダイアログを表示します。 |
static String |
showInputDialog(Component parentComponent,
Object message,
String title,
int messageType)
parentComponent を親としてユーザに入力を求めるダイアログを表示します。 |
static Object |
showInputDialog(Component parentComponent,
Object message,
String title,
int messageType,
Icon icon,
Object[] selectionValues,
Object initialSelectionValue)
初期選択、指定可能な選択項目、およびそれ以外のすべてのオプションの指定が可能なブロッキングダイアログでユーザに入力を求めます。 |
static String |
showInputDialog(Object message)
ユーザに入力を求めるクエスチョンメッセージダイアログを表示します。 |
static int |
showInternalConfirmDialog(Component parentComponent,
Object message)
オプションが「Yes」、「No」、および「Cancel」でタイトルが「Select an Option」の内部ダイアログパネルを表示します。 |
static int |
showInternalConfirmDialog(Component parentComponent,
Object message,
String title,
int optionType)
optionType パラメータで選択項目数が決まる内部ダイアログパネルを表示します。 |
static int |
showInternalConfirmDialog(Component parentComponent,
Object message,
String title,
int optionType,
int messageType)
optionType パラメータで選択項目数が決まる内部ダイアログパネルを表示します。 |
static int |
showInternalConfirmDialog(Component parentComponent,
Object message,
String title,
int optionType,
int messageType,
Icon icon)
指定されたアイコンを持つ内部ダイアログパネルを表示します。 |
static String |
showInternalInputDialog(Component parentComponent,
Object message)
parentComponent を親として、ユーザに入力を求める内部クエスチョンメッセージダイアログを表示します。 |
static String |
showInternalInputDialog(Component parentComponent,
Object message,
String title,
int messageType)
parentComponent を親として、ユーザに入力を求める内部ダイアログを表示します。 |
static Object |
showInternalInputDialog(Component parentComponent,
Object message,
String title,
int messageType,
Icon icon,
Object[] selectionValues,
Object initialSelectionValue)
初期選択、指定可能な選択項目、およびそれ以外のすべてのオプションの指定が可能なブロッキング内部ダイアログでユーザに入力を求めます。 |
static void |
showInternalMessageDialog(Component parentComponent,
Object message)
内部確認ダイアログパネルを表示します。 |
static void |
showInternalMessageDialog(Component parentComponent,
Object message,
String title,
int messageType)
messageType パラメータで指定されたデフォルトアイコンを使用して、メッセージを表示するための内部ダイアログパネルを表示します。 |
static void |
showInternalMessageDialog(Component parentComponent,
Object message,
String title,
int messageType,
Icon icon)
すべてのパラメータを指定して、メッセージを表示するための内部ダイアログパネルを表示します。 |
static int |
showInternalOptionDialog(Component parentComponent,
Object message,
String title,
int optionType,
int messageType,
Icon icon,
Object[] options,
Object initialValue)
指定されたアイコンを持つ内部ダイアログパネルを表示します。 |
static void |
showMessageDialog(Component parentComponent,
Object message)
確認ダイアログを表示します。 |
static void |
showMessageDialog(Component parentComponent,
Object message,
String title,
int messageType)
messageType パラメータで指示されたデフォルトのアイコンを使用して、メッセージを表示するためのダイアログを表示します。 |
static void |
showMessageDialog(Component parentComponent,
Object message,
String title,
int messageType,
Icon icon)
すべてのパラメータを指定して、メッセージを表示するためのダイアログを表示します。 |
static int |
showOptionDialog(Component parentComponent,
Object message,
String title,
int optionType,
int messageType,
Icon icon,
Object[] options,
Object initialValue)
指定されたアイコンを持つモーダルダイアログを表示します。 |
void |
updateUI()
L&F が変更されたことを示す UIManager からの通知です。 |
クラス java.lang.Object から継承したメソッド |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
フィールドの詳細 |
public static final Object UNINITIALIZED_VALUE
public static final int DEFAULT_OPTION
public static final int YES_NO_OPTION
public static final int YES_NO_CANCEL_OPTION
public static final int OK_CANCEL_OPTION
public static final int YES_OPTION
public static final int NO_OPTION
public static final int CANCEL_OPTION
public static final int OK_OPTION
public static final int CLOSED_OPTION
public static final int ERROR_MESSAGE
public static final int INFORMATION_MESSAGE
public static final int WARNING_MESSAGE
public static final int QUESTION_MESSAGE
public static final int PLAIN_MESSAGE
public static final String ICON_PROPERTY
public static final String MESSAGE_PROPERTY
public static final String VALUE_PROPERTY
public static final String OPTIONS_PROPERTY
public static final String INITIAL_VALUE_PROPERTY
public static final String MESSAGE_TYPE_PROPERTY
public static final String OPTION_TYPE_PROPERTY
public static final String SELECTION_VALUES_PROPERTY
public static final String INITIAL_SELECTION_VALUE_PROPERTY
public static final String INPUT_VALUE_PROPERTY
public static final String WANTS_INPUT_PROPERTY
protected transient Icon icon
protected transient Object message
protected transient Object[] options
protected transient Object initialValue
protected int messageType
protected int optionType
protected transient Object value
protected transient Object[] selectionValues
protected transient Object inputValue
protected transient Object initialSelectionValue
protected boolean wantsInput
コンストラクタの詳細 |
public JOptionPane()
public JOptionPane(Object message)
message
- 表示する Objectpublic JOptionPane(Object message, int messageType)
message
- 表示する ObjectmessageType
- 表示されるメッセージのタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEpublic JOptionPane(Object message, int messageType, int optionType)
message
- 表示する ObjectmessageType
- 表示されるメッセージのタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEoptionType
- 区画に表示するオプション。DEFAULT_OPTION、YES_NO_OPTION、YES_NO_CANCEL_OPTION、OK_CANCEL_OPTIONpublic JOptionPane(Object message, int messageType, int optionType, Icon icon)
message
- 表示する ObjectmessageType
- 表示されるメッセージタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEoptionType
- 区画に表示するオプション。DEFAULT_OPTION、YES_NO_OPTION、YES_NO_CANCEL_OPTION、OK_CANCEL_OPTIONicon
- 表示する Icon イメージpublic JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options)
オプションオブジェクトには、直接登録される Component または JButton 内にラップされる String のどちらかのインスタンスを格納する必要があります。Component を提供する場合は、Component がクリックされたときに、生成された JOptionPane で Component が setValue
が通知することを保証しなければなりません。
message
- 表示する ObjectmessageType
- 表示されるメッセージタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEoptionType
- 区画に表示するオプション。DEFAULT_OPTION、YES_NO_OPTION、YES_NO_CANCEL_OPTION、OK_CANCEL_OPTION。options
パラメータが null の場合にだけ有効icon
- 表示する Icon イメージoptions
- ユーザが選択可能な項目public JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options, Object initialValue)
message
- 表示する ObjectmessageType
- 表示されるメッセージタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEoptionType
- 区画に表示するオプション。DEFAULT_OPTION、YES_NO_OPTION、YES_NO_CANCEL_OPTION、OK_CANCEL_OPTION。options
パラメータが null の場合にだけ有効icon
- 表示する Icon イメージoptions
- ユーザが選択可能な項目initialValue
- 初期状態で選択されている項目メソッドの詳細 |
public static String showInputDialog(Object message)
message
- 表示する Objectpublic static String showInputDialog(Component parentComponent, Object message)
parentComponent
を親として、ユーザに入力を求めるクエスチョンメッセージダイアログを表示します。ダイアログは、Component のフレーム内に表示され、通常は Component の下に配置されます。parentComponent
- ダイアログの親 Componentmessage
- 表示する Objectpublic static String showInputDialog(Component parentComponent, Object message, String title, int messageType)
parentComponent
を親としてユーザに入力を求めるダイアログを表示します。ダイアログのタイトルは title
で、メッセージタイプは messageType
です。parentComponent
- ダイアログの親 Componentmessage
- 表示する Objecttitle
- ダイアログのタイトルバーに表示する StringmessageType
- 表示されるメッセージタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEpublic static Object showInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue)
selectionValues
で指定します。null の場合、ユーザは任意の値を入力することができます。入力の手段は通常は JTextField です。initialSelectionValue
はユーザに示す初期値です。selectionValues
をどのように最適に提示するかは UI 次第ですが、通常は JComboBox、JList、または JTextField を使用します。parentComponent
- ダイアログの親 Componentmessage
- 表示する Objecttitle
- ダイアログのタイトルバーに表示する StringmessageType
- 表示されるメッセージタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEicon
- 表示する Icon イメージselectionValues
- 選択項目を提示する Object の配列initialSelectionValue
- 入力フィールドを初期化する値public static void showMessageDialog(Component parentComponent, Object message)
parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 表示する Objectpublic static void showMessageDialog(Component parentComponent, Object message, String title, int messageType)
parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 表示する Objecttitle
- ダイアログのタイトル文字列messageType
- 表示されるメッセージタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEpublic static void showMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon)
parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 表示する Objecttitle
- ダイアログのタイトル文字列messageType
- 表示されるメッセージタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEicon
- 表示されているメッセージの種類をユーザが認識する作業を助ける、ダイアログに表示するアイコンpublic static int showConfirmDialog(Component parentComponent, Object message)
parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 表示する Objectpublic static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType)
optionType
パラメータで選択項目数が決まるモーダルダイアログを表示します。parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 表示する Objecttitle
- ダイアログのタイトル文字列optionType
- ダイアログボックスで選択可能なオプションを指示する int 値。YES_NO_OPTION または YES_NO_CANCEL_OPTIONpublic static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)
optionType
パラメータで選択項目数が決まるモーダルダイアログを表示します。表示するアイコンは messageType
パラメータで決まります。messageType
パラメータは主に、Look & Feel から決まるデフォルトアイコンを決定するために使用します。parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 表示する Objecttitle
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを指示する int 値。YES_NO_OPTION または YES_NO_CANCEL_OPTIONmessageType
- 主にプラグイン可能な Look & Feel のアイコンを指定するために使用されるメッセージの種類を表す int 値。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEpublic static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon)
optionType
パラメータで決まります。Look & Feel からのデフォルトアイコンを提示するには、主に messageType
パラメータを使用します。parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 表示する Objecttitle
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを指示する int 値。YES_NO_OPTION または YES_NO_CANCEL_OPTIONmessageType
- 主にプラグイン可能な Look & Feel のアイコンを指定するために使用されるメッセージの種類を表す int 値。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEicon
- ダイアログに表示するアイコンpublic static int showOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue)
initialValue
パラメータで、選択項目数は optionType
パラメータで決まります。
optionType
が YES_NO_OPTION または YES_NO_CANCEL_OPTIONIf で options
パラメータが null の場合、オプションは Look & Feel により提供されます。
Look & Feel からのデフォルトアイコンを提示するには、主に messageType
パラメータを使用します。
parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 表示する Objecttitle
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを指示する int 値。YES_NO_OPTION または YES_NO_CANCEL_OPTIONmessageType
- 主にプラグイン可能な Look & Feel のアイコンを指定するために使用されるメッセージの種類を表す int 値。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE または PLAIN_MESSAGEicon
- ダイアログに表示するアイコンoptions
- ユーザが選択可能な項目を示すオブジェクトの配列。オブジェクトがコンポーネントの場合は適切に描画される。String 以外のオブジェクトは toString
メソッドを使用して描画される。このパラメータが null の場合、オプションは Look & Feel から決まるinitialValue
- ダイアログのデフォルトの選択を表すオブジェクトpublic JDialog createDialog(Component parentComponent, String title)
parentComponent
のフレーム内の parentComponent
の中央に this
をラップして新しい JDialog を生成して返します。title
は返されるダイアログのタイトルです。返される JDialog は、閉じられるか、あるいはユーザが「OK」ボタンをクリックした状態に設定されます。ダイアログは閉じられて破棄されます。parentComponent に Frame がない場合は、デフォルトの Frame が使用されます。title
- ダイアログのタイトル文字列public static void showInternalMessageDialog(Component parentComponent, Object message)
parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 表示する Objectpublic static void showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType)
parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 表示する Objecttitle
- ダイアログのタイトル文字列messageType
- 表示されるメッセージタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE または PLAIN_MESSAGEpublic static void showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon)
parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 表示する Objecttitle
- ダイアログのタイトル文字列messageType
- 表示されるメッセージタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE または PLAIN_MESSAGEicon
- 表示されるメッセージの種類をユーザが認識できるようにするための、ダイアログに表示するアイコンpublic static int showInternalConfirmDialog(Component parentComponent, Object message)
parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 表示する Objectpublic static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType)
optionType
パラメータで選択項目数が決まる内部ダイアログパネルを表示します。parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- ダイアログに表示するオブジェクト。Component オブジェクトは Component として描画される。String オブジェクトは文字列として描画される。それ以外のオブジェクトは toString
メソッドで String に変換されるtitle
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを指示する int 値。YES_NO_OPTION または YES_NO_CANCEL_OPTIONpublic static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)
optionType
パラメータで選択項目数が決まる内部ダイアログパネルを表示します。表示するアイコンは messageType
パラメータで決まります。messageType
パラメータは主に、Look & Feel から決まるデフォルトアイコンを提供するために使用します。parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- ダイアログに表示するオブジェクト。Component オブジェクトは Component として描画される。String オブジェクトは文字列として描画される。それ以外のオブジェクトは toString
メソッドで String に変換されるtitle
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを指示する int 値。YES_NO_OPTION または YES_NO_CANCEL_OPTIONmessageType
- 主にプラグイン可能な Look & Feel のアイコンを指定するために使用されるメッセージの種類を表す int 値。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE または PLAIN_MESSAGEpublic static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon)
optionType
パラメータで決まります。Look & Feel からのデフォルトアイコンを提示するには、主に messageType
パラメータを使用します。parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- 文字列ダイアログに表示するオブジェクト。Component オブジェクトは Component として描画される。String オブジェクトは文字列として描画される。それ以外のオブジェクトは toString
メソッドで String に変換されるtitle
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを指示する int 値。YES_NO_OPTION または YES_NO_CANCEL_OPTIONmessageType
- 主にプラグイン可能な Look & Feel のアイコンを指定するために使用されるメッセージの種類を表す int 値。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE または PLAIN_MESSAGEicon
- ダイアログに表示するアイコンpublic static int showInternalOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue)
initialValue
パラメータ、選択項目数は optionType
パラメータで決まります。
optionType
が YES_NO_OPTION または YES_NO_CANCEL_OPTION で options
パラメータが null の場合、オプションは Look & Feel によって提供されます。
Look & Feel からのデフォルトアイコンを提示するには、主に messageType
パラメータを使用します。
parentComponent
- ダイアログを表示する Frame を指定する。null の場合、または parentComponent に Frame がない場合は、デフォルトの Frame が使用されるmessage
- ダイアログに表示するオブジェクト。Component オブジェクトは Component として描画される。String オブジェクトは文字列として描画される。それ以外のオブジェクトは toString
メソッドで String に変換されるtitle
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを指示する int 値。YES_NO_OPTION または YES_NO_CANCEL_OPTIONmessageType
- 主にプラグイン可能な Look & Feel のアイコンを指定するために使用されるメッセージの種類を表す int 値。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE または PLAIN_MESSAGEicon
- ダイアログに表示するアイコンoptions
- ユーザが選択可能な項目を示すオブジェクトの配列。オブジェクトがコンポーネントの場合は適切に描画される。String 以外のオブジェクトは toString
メソッドを使用して描画される。このパラメータが null の場合、オプションは Look & Feel で決まるinitialValue
- ダイアログのデフォルト選択を示すオブジェクトpublic static String showInternalInputDialog(Component parentComponent, Object message)
parentComponent
を親として、ユーザに入力を求める内部クエスチョンメッセージダイアログを表示します。ダイアログは、Component のフレーム内に表示され、通常は Component の下に配置されます。parentComponent
- ダイアログの親 Componentmessage
- 表示する Objectpublic static String showInternalInputDialog(Component parentComponent, Object message, String title, int messageType)
parentComponent
を親として、ユーザに入力を求める内部ダイアログを表示します。ダイアログのタイトルは title
で、メッセージタイプは messageType
です。parentComponent
- ダイアログの親 Componentmessage
- 表示する Objecttitle
- ダイアログのタイトルバーに表示する StringmessageType
- 表示されるメッセージタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE または PLAIN_MESSAGEpublic static Object showInternalInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue)
selectionValues
で指定します。null の場合、ユーザは任意の値を入力することができます。入力の手段は通常は JTextField です。initialSelectionValue
はユーザに示す初期値です。selectionValues
をどのように最適に提示するかは UI 次第ですが、通常は JComboBox、JList、または JTextField を使用します。parentComponent
- ダイアログの親 Componetmessage
- 表示する Objecttitle
- ダイアログのタイトルバーに表示する StringmessageType
- 表示されるメッセージタイプ。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE または PLAIN_MESSAGEicon
- 表示する Icon イメージselectionValues
- 選択可能な項目を示す Object 配列initialSelectionValue
- 入力フィールドを初期化する値public JInternalFrame createInternalFrame(Component parentComponent, String title)
RuntimeException
がスローされます。parentComponent
- 内部フレームの親 Componenttitle
- フレームのタイトルバー内に表示する Stringpublic static Frame getFrameForComponent(Component parentComponent)
parentComponent
- Frame を調べる Componentpublic static JDesktopPane getDesktopPaneForComponent(Component parentComponent)
parentComponent
- デスクトップを調べる Componentpublic static void setRootFrame(Frame newRootFrame)
newRootFrame
- 使用するデフォルトの Framepublic static Frame getRootFrame()
public void setUI(OptionPaneUI ui)
ui
- OptionPaneUI L&F オブジェクトUIDefaults.getUI(javax.swing.JComponent)
public OptionPaneUI getUI()
public void updateUI()
JComponent.updateUI()
public String getUIClassID()
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public void setMessage(Object newMessage)
newMessage
- 表示する ObjectgetMessage()
public Object getMessage()
setMessage(java.lang.Object)
public void setIcon(Icon newIcon)
newIcon
- 表示する IcongetIcon()
public Icon getIcon()
setIcon(javax.swing.Icon)
public void setValue(Object newValue)
newValue
- 選択された値getValue()
public Object getValue()
setValue(java.lang.Object)
public void setOptions(Object[] newOptions)
newOptions
- ユーザがクリック可能なボタンを作成する Object の配列または区画に登録する任意の ComponentgetOptions()
public Object[] getOptions()
setOptions(java.lang.Object[])
public void setInitialValue(Object newInitialValue)
newInitialValue
- 初期キーボードフォーカスを取得する ObjectgetInitialValue()
public Object getInitialValue()
setInitialValue(java.lang.Object)
public void setMessageType(int newType)
newType
- 表示するメッセージの種類を指定する int 値。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE または PLAIN_MESSAGE。それ以外では RuntimeEception がスローされるgetMessageType()
public int getMessageType()
setMessageType(int)
public void setOptionType(int newType)
newType
- Look & Feel が表示するオプションを指定する int 値。DEFAULT_OPTION、YES_NO_OPTION、YES_NO_CANCEL_OPTION、または OK_CANCEL_OPTION。それ以外は RuntimeException がスローされるgetOptionType()
,
setOptions(java.lang.Object[])
public int getOptionType()
setOptionType(int)
public void setSelectionValues(Object[] newValues)
wantsInput
を true に設定します。setInitialSelectionValue
を使用して初期選択値を指定します。区画が有効になると、inputValue はユーザが選択した値に設定されます。
newValues
- ユーザが選択したもののうちで表示可能な Object の配列で、通常はリスト形式またはコンボボックス形式setWantsInput(boolean)
,
setInitialSelectionValue(java.lang.Object)
,
getSelectionValues()
public Object[] getSelectionValues()
setSelectionValues(java.lang.Object[])
public void setInitialSelectionValue(Object newValue)
wantsInput
が true の場合にだけ使用されます。newValue
- 初期選択値setSelectionValues(java.lang.Object[])
,
getInitialSelectionValue()
public Object getInitialSelectionValue()
setInitialSelectionValue(java.lang.Object)
,
setSelectionValues(java.lang.Object[])
public void setInputValue(Object newValue)
newValue
- ユーザが通常はテキストフィールド内で指定した値の初期化に必要な ObjectsetSelectionValues(java.lang.Object[])
,
setWantsInput(boolean)
,
getInputValue()
public Object getInputValue()
wantsInput
が true の場合に、ユーザが入力した数値を返しますsetSelectionValues(java.lang.Object[])
,
setWantsInput(boolean)
,
setInputValue(java.lang.Object)
public int getMaxCharactersPerLineCount()
public void setWantsInput(boolean newValue)
newValue
が true の場合は、ユーザが数値を入力できるように parentComponent が提供されます。入力値は、getSelectionValues
が null 以外の値を返す場合は配列内のどれかのオブジェクト、そうでない場合はユーザが入力した値です。
これはバウンドプロパティです。
setSelectionValues(java.lang.Object[])
,
setInputValue(java.lang.Object)
public boolean getWantsInput()
setWantsInput(boolean)
public void selectInitialValue()
protected String paramString()
null
にはなりません。
JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。
public AccessibleContext getAccessibleContext()
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |