|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JOptionPane
JOptionPane
によって、ユーザに値の入力を求めたり情報を提示したりする標準のダイアログボックスを簡単に表示することができます。JOptionPane
の使用についての詳細は、「The Java Tutorial」の「How to Make Dialogs」を参照してください。
メソッドの数が多いために JOptionPane
クラスは複雑そうに見えますが、このクラスの使用法はほとんどすべて、以下に示す静的な showXxxDialog
メソッドのどれかに対するオンライン呼び出しです。
以上の 3 つの各メソッドは、内部フレームを使用してダイアログボックスを保持する
showConfirmDialog yes/no/cancel 等の確認の要求 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
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
配列です。ただし、パラメータ型はObjects
配列です。ボタンはその型に応じて各オブジェクトについて作成されます。
- 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, or CLOSED_OPTION.例
JOptionPane.showMessageDialog(null, "alert", "alert",
JOptionPane.ERROR_MESSAGE);
JOptionPane.showInternalMessageDialog(frame, "information",
"information", JOptionPane.INFORMATION_MESSAGE);
JOptionPane.showConfirmDialog(null,
"choose one", "choose one", JOptionPane.YES_NO_OPTION);
JOptionPane.showInternalConfirmDialog(frame,
"please choose one", "information",
JOptionPane.YES_NO_CANCEL_OPTION, JOptionPane.INFORMATION_MESSAGE);
Object[] options = { "OK", "CANCEL" };
JOptionPane.showOptionDialog(null, "Click OK to continue", "Warning",
JOptionPane.DEFAULT_OPTION, JOptionPane.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
を直接生成して使用するための標準パターンの概略は以下のとおりです。
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
このクラスは JOptionPane クラス用のユーザ補助機能のサポートを実装しています。 |
クラス javax.swing.JComponent から継承した内部クラス |
JComponent.AccessibleJComponent |
クラス java.awt.Container から継承した内部クラス |
Container.AccessibleAWTContainer |
クラス java.awt.Component から継承した内部クラス |
Component.AccessibleAWTComponent |
フィールドの概要 | |
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 |
インタフェース java.awt.image.ImageObserver から継承したフィールド |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
コンストラクタの概要 | |
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()
この JOptionPane に関連した 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()
フレームが提供されないクラスメソッドで使用する Frame を返します。 |
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)
「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
null
になります。protected transient Object[] selectionValues
protected transient Object inputValue
protected transient Object initialSelectionValue
protected boolean wantsInput
コンストラクタの詳細 |
public JOptionPane()
JOptionPane
を生成します。public JOptionPane(Object message)
JOptionPane
のインスタンスを生成します。message
- 表示する Object
public JOptionPane(Object message, int messageType)
JOptionPane
のインスタンスを生成します。message
- 表示する Object
messageType
- 表示されるメッセージの種類。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEpublic JOptionPane(Object message, int messageType, int optionType)
JOptionPane
のインスタンスを生成します。message
- 表示する Object
messageType
- 表示されるメッセージの種類。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)
JOptionPane
のインスタンスを生成します。message
- 表示する Object
messageType
- 表示されるメッセージの種類。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
- 表示する Object
messageType
- 表示されるメッセージの種類。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)
JOptionPane
のインスタンスを生成します。message
- 表示する Object
messageType
- 表示されるメッセージの種類。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
- 表示する Object
public static String showInputDialog(Component parentComponent, Object message)
parentComponent
を親として、ユーザに入力を求めるクエスチョンメッセージダイアログを表示します。ダイアログは、Component のフレーム内に表示され、通常は Component
の下に配置されます。parentComponent
- ダイアログの親 Component
message
- 表示する Object
public static String showInputDialog(Component parentComponent, Object message, String title, int messageType)
parentComponent
を親としてユーザに入力を求めるダイアログを表示します。ダイアログのタイトルは title
で、メッセージタイプは messageType
です。parentComponent
- ダイアログの親 Component
message
- 表示する Object
title
- ダイアログのタイトルバーに表示する String
messageType
- 表示されるメッセージの種類。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
- ダイアログの親 Component
message
- 表示する Object
title
- ダイアログのタイトルバーに表示する String
messageType
- 表示されるメッセージの種類。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEicon
- 表示する Icon イメージselectionValues
- 選択可能な項目を示す Object
の配列initialSelectionValue
- 入力フィールドを初期化する値null
の場合はユーザが入力を取り消したことを意味するpublic static void showMessageDialog(Component parentComponent, Object message)
parentComponent
- ダイアログを表示する Frame
を指定する。null
の場合、または parentComponent
に Frame
がない場合は、デフォルトの Frame
が使用されるmessage
- 表示する Object
public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType)
messageType
パラメータで指示されたデフォルトのアイコンを使用して、メッセージを表示するためのダイアログを表示します。parentComponent
- ダイアログを表示する Frame
を指定する。null
の場合、または parentComponent
に Frame
がない場合は、デフォルトの Frame
が使用されるmessage
- 表示する Object
title
- ダイアログのタイトル文字列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
- 表示する Object
title
- ダイアログのタイトル文字列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
- 表示する Object
public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType)
optionType
パラメータで選択項目数が決まるモーダルダイアログを表示します。parentComponent
- ダイアログを表示する Frame
を指定する。null
の場合、または parentComponent
に Frame
がない場合は、デフォルトの Frame
が使用されるmessage
- 表示する Object
title
- ダイアログのタイトル文字列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
- 表示する Object
title
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを指示する整数。YES_NO_OPTION または YES_NO_CANCEL_OPTIONmessageType
- 主にプラグイン可能な Look & Feel のアイコンを指定するために使用されるメッセージの種類を表す整数。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_OPTION で options
パラメータが null
の場合、オプションは Look & Feel によって提供されます。
Look & Feel からのデフォルトアイコンを提示するには、主に messageType
パラメータを使用します。
parentComponent
- ダイアログを表示する Frame
を指定する。null
の場合、または parentComponent
に Frame
がない場合は、デフォルトの Frame
が使用されるmessage
- 表示する Object
title
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを指示する整数。YES_NO_OPTION または YES_NO_CANCEL_OPTIONmessageType
- 主にプラグイン可能な Look & Feel のアイコンを指定するために使用されるメッセージの種類を表す整数。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 を指定する。parentComponent
に Frame
がない場合は、デフォルトの Frame
が使用されるtitle
- ダイアログのタイトル文字列JDialog
public static void showInternalMessageDialog(Component parentComponent, Object message)
parentComponent
- ダイアログを表示する Frame
を指定する。null
の場合、または parentComponent
に Frame
がない場合は、デフォルトの Frame
が使用されるmessage
- 表示するオブジェクトpublic static void showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType)
messageType
パラメータで指定されたデフォルトアイコンを使用して、メッセージを表示するための内部ダイアログパネルを表示します。parentComponent
- ダイアログを表示する Frame
を指定する。null
の場合、または parentComponent
に Frame
がない場合は、デフォルトの Frame
が使用されるmessage
- 表示する Object
title
- ダイアログのタイトル文字列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
- 表示する Object
title
- ダイアログのタイトル文字列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
- 表示する Object
public 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
- ダイアログで選択可能なオプションを指示する整数。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
- ダイアログで選択可能なオプションを指示する整数。YES_NO_OPTION または YES_NO_CANCEL_OPTIONmessageType
- 主にプラグイン可能な Look & Feel のアイコンを指定するために使用されるメッセージの種類を表す整数。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
- ダイアログで選択可能なオプションを指示する整数。YES_NO_OPTION または YES_NO_CANCEL_OPTIONmessageType
- 主にプラグイン可能な Look & Feel のアイコンを指定するために使用されるメッセージの種類を表す整数。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
- ダイアログで選択可能なオプションを指示する整数。YES_NO_OPTION または YES_NO_CANCEL_OPTIONmessageType
- 主にプラグイン可能な Look & Feel のアイコンを指定するために使用されるメッセージの種類を表す整数。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
- ダイアログの親 Component
message
- 表示する Object
public static String showInternalInputDialog(Component parentComponent, Object message, String title, int messageType)
parentComponent
を親として、ユーザに入力を求める内部ダイアログを表示します。ダイアログのタイトルは title
で、メッセージタイプは messageType
です。parentComponent
- ダイアログの親 Component
message
- 表示する Object
title
- ダイアログのタイトルバーに表示する String
messageType
- 表示されるメッセージの種類。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
- ダイアログの親 Component
message
- 表示する Object
title
- ダイアログのタイトルバーに表示する String
messageType
- 表示されるメッセージの種類。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGEicon
- 表示する Icon
イメージselectionValues
- 選択可能な項目を示す Objects
の配列initialSelectionValue
- 入力フィールドを初期化する値null
の場合はユーザが入力を取り消したことを意味するpublic JInternalFrame createInternalFrame(Component parentComponent, String title)
JInternalFrame
のインスタンスを生成して返します。内部フレームは、JOptionPane
をラップして指定されたタイトルで生成されます。返される JInternalFrame
は parentComponent
の JDesktopPane
の上位オブジェクトに、または上位オブジェクトが JDesktopPane
でない場合はコンポーネントの親に、登録されます。parentComponent
に親がない場合は、RuntimeException
がスローされます。parentComponent
- 内部フレームの親 Component
title
- フレームのタイトルバー内に表示する String
JOptionPane
を含む JInternalFrame
RuntimeException
- parentComponent
が有効な親を持っていない場合public static Frame getFrameForComponent(Component parentComponent)
Frame
を返します。parentComponent
- Frame
を調べる Component
Frame
。コンポーネントが null
の場合、または有効な Frame
の親を持たない場合はデフォルトフレームpublic static JDesktopPane getDesktopPaneForComponent(Component parentComponent)
parentComponent
- デスクトップを調べる Component
JDesktopPane
。コンポーネントが null
の場合、または JInternalFrame
の上位オブジェクトを持たない場合は null
public static void setRootFrame(Frame newRootFrame)
newRootFrame
- 使用するデフォルトの Frame
public static Frame getRootFrame()
Frame
を返します。Frame
public void setUI(OptionPaneUI ui)
ui
- OptionPaneUI
の L&F オブジェクトUIDefaults.getUI(javax.swing.JComponent)
public OptionPaneUI getUI()
OptionPaneUI
オブジェクトpublic void updateUI()
UIManager
からの通知です。現在の UI オブジェクトを UIManager
からの最新バージョンに置き換えます。JComponent
内の updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
内の getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public void setMessage(Object newMessage)
newMessage
- 表示する Object
getMessage()
public Object getMessage()
Object
setMessage(java.lang.Object)
public void setIcon(Icon newIcon)
null
でない場合、Look & Feel はアイコンを提供しません。icon
- 表示する Icon
getIcon()
public Icon getIcon()
Icon
setIcon(javax.swing.Icon)
public void setValue(Object newValue)
newValue
- 選択した値getValue()
public Object getValue()
null
はユーザが何も選択せずにウィンドウを閉じたことを示します。それ以外の戻り値は、このオブジェクトで定義されるオプションのどれかです。Object
。ユーザが選択を行なっていない場合は UNINITIALIZED_VALUE、ユーザが選択を行わずにウィンドウを閉じた場合は null
setValue(java.lang.Object)
public void setOptions(Object[] newOptions)
newOptions
内の要素が Component
の場合は、区画に直接登録されます。そうでない場合は、要素に対してボタンが作成されます。newOptions
- ユーザがクリック可能なボタンを作成する Object
の配列、または区画に登録する任意の Component
getOptions()
public Object[] getOptions()
Object
の配列setOptions(java.lang.Object[])
public void setInitialValue(Object newInitialValue)
Component
です。newInitialValue
- 初期キーボードフォーカスを取得する Object
getInitialValue()
public Object getInitialValue()
Object
setInitialValue(java.lang.Object)
public void setMessageType(int newType)
parentComponent
のレイアウト方法を決定するために、Look & Feel が使用します。newType
- 表示するメッセージの種類を指定する整数。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、または PLAIN_MESSAGERuntimeException
- newType
が上記の正当な値のどれかではない場合getMessageType()
public int getMessageType()
setMessageType(int)
public void setOptionType(int newType)
newType
- Look & Feel が表示するオプションを指定する整数。DEFAULT_OPTION、YES_NO_OPTION、YES_NO_CANCEL_OPTION、または OK_CANCEL_OPTIONRuntimeException
- newType
が上記の正当な値のどれかではない場合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()
return
- ユーザが選択できる Object
の配列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
- (通常はテキストフィールド内で) ユーザが指定した値の初期化に必要な Object
setSelectionValues(java.lang.Object[])
,
setWantsInput(boolean)
,
getInputValue()
public Object getInputValue()
wantsInput
が true の場合に、ユーザが入力した数値を返しますObject
、フィールドに入力された値の場合は String
setSelectionValues(java.lang.Object[])
,
setWantsInput(boolean)
,
setInputValue(java.lang.Object)
public int getMaxCharactersPerLineCount()
Integer.MAX_VALUE
を返します。この値を変更するには、サブクラスでこのメソッドをオーバーライドします。public void setWantsInput(boolean newValue)
newValue
が true の場合は、ユーザが値を入力できるように parentComponent
が提供されます。入力値は、getSelectionValues
が null
以外の値を返す場合は配列内のオブジェクトのどれか、そうでない場合はユーザが入力した値です。
これはバウンドプロパティです。
setSelectionValues(java.lang.Object[])
,
setInputValue(java.lang.Object)
public boolean getWantsInput()
parentComponent
がユーザの入力用に提供される場合に true を返します。parentComponent
が提供される場合は truesetWantsInput(boolean)
public void selectInitialValue()
protected String paramString()
JOptionPane
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。JComponent
内の paramString
JOptionPane
の文字列表現public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
JComponent
内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.