public class JOptionPane extends JComponent implements Accessible
JOptionPaneは、ユーザーに値の入力を求めたり、何らかの情報を通知したりするための標準のダイアログ・ボックスを容易にポップアップできるようにします。 JOptionPaneの使用方法については、「The Java Tutorial」の「How to Make Dialogs」を参照してください。
メソッドの数が多いためにJOptionPaneクラスは複雑そうに見えますが、このクラスの使用法はほとんどすべて、次に示す静的なshowXxxDialogメソッドのいずれかに対するオンライン呼出しです。
以上の3つの各メソッドは、内部フレームを使用してダイアログ・ボックスを保持する
メソッド名 説明 showConfirmDialog yes/no/cancelなどの確認の要求。 showInputDialog 入力プロンプト。 showMessageDialog 発生したことについてのユーザーへのメッセージ。 showOptionDialog 以上の3つを合わせたもの。
showInternalXXXの特長を備えています(JInternalFrameを参照)。 異なるパラメータ・リストを使用する基本メソッドをオーバーロードしたバージョンなど、いくつかの簡易メソッドも定義されています。
すべてのダイアログはモーダルです。 各showXxxDialogメソッドは、ユーザーの対話が終了するまで呼出し側をブロックします。
| icon | message |
| 入力値 | |
| オプション・ボタン | |
ComponentOrientationプロパティに適応するようにレイアウトを調整します。
パラメータ:
これらのメソッドに対するパラメータは一貫性のあるパターンになります。
- 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
- メッセージのスタイルを定義します。 ルック・アンド・フィールマネージャは、この値に応じてダイアログを個別に配置し、通常はデフォルトのアイコンを用意します。 返される値は次のどれかになります。
ERROR_MESSAGEINFORMATION_MESSAGEWARNING_MESSAGEQUESTION_MESSAGEPLAIN_MESSAGE- optionType
- ダイアログ・ボックスの下部に表示されるオプション・ボタンのセットを定義します。
使用できるのはこれらのオプション・ボタンにかぎりません。 optionsパラメータを使用して任意のボタンを指定することができます。
DEFAULT_OPTIONYES_NO_OPTIONYES_NO_CANCEL_OPTIONOK_CANCEL_OPTION- options
- ダイアログ・ボックスの下部に表示されるオプション・ボタンの詳細な説明です。 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
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;
警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4以降、すべてのJavaBeans™用の長期間の格納サポートがjava.beansパッケージに追加されています。 XMLEncoderを参照してください。
JInternalFrame| 修飾子と型 | クラス | 説明 |
|---|---|---|
protected class |
JOptionPane.AccessibleJOptionPane |
このクラスは
JOptionPaneクラスのアクセシビリティ・サポートを実装しています。 |
JComponent.AccessibleJComponentContainer.AccessibleAWTContainerComponent.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy| 修飾子と型 | フィールド | 説明 |
|---|---|---|
static int |
CANCEL_OPTION |
「CANCEL」が選択された場合にクラス・メソッドから返される値です。
|
static int |
CLOSED_OPTION |
ユーザーが何も選択せずにウィンドウを閉じた場合にクラス・メソッドから返される値です。多くの場合は
CANCEL_OPTIONまたはNO_OPTIONとして処理されます。 |
static int |
DEFAULT_OPTION |
ルック・アンド・フィールを意味する型はオプションを提供しません。
JOptionPaneのオプションだけを使用します。 |
static int |
ERROR_MESSAGE |
エラー・メッセージで使用します。
|
protected Icon |
icon |
ペインで使用されるアイコンです。
|
static String |
ICON_PROPERTY |
iconのバウンド・プロパティ名です。 |
static int |
INFORMATION_MESSAGE |
情報メッセージで使用します。
|
static String |
INITIAL_SELECTION_VALUE_PROPERTY |
initialSelectionValueのバウンド・プロパティ名です。 |
static String |
INITIAL_VALUE_PROPERTY |
initialValueのバウンド・プロパティ名です。 |
protected Object |
initialSelectionValue |
selectionValuesで選択する初期値です。 |
protected Object |
initialValue |
optionsで初期状態で選択される値です。 |
static String |
INPUT_VALUE_PROPERTY |
inputValueのバウンド・プロパティ名です。 |
protected Object |
inputValue |
ユーザーが入力した値です。
|
protected Object |
message |
表示するメッセージです。
|
static String |
MESSAGE_PROPERTY |
messageのバウンド・プロパティ名です。 |
static String |
MESSAGE_TYPE_PROPERTY |
typeのバウンド・プロパティ名です。 |
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 |
optionのバウンド・プロパティ名です。 |
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 |
現在選択されている値です。有効なオプションか、
UNINITIALIZED_VALUEまたはnullです。 |
static String |
VALUE_PROPERTY |
valueのバウンド・プロパティ名です。 |
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」が選択された場合にクラス・メソッドから返される値です。
|
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOWaccessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, 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を作成して返します。 |
JDialog |
createDialog(String title) |
指定されたタイトルで、親を持たない新しい
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() |
wantsInputプロパティの値を返します。 |
protected String |
paramString() |
この
JOptionPaneの文字列表現を返します。 |
void |
selectInitialValue() |
初期値を選択するように要求します。初期値にはフォーカスが設定されます。
|
void |
setIcon(Icon newIcon) |
表示するアイコンを設定します。
|
void |
setInitialSelectionValue(Object newValue) |
初期選択値としてユーザーに対して表示される入力値を設定します。
|
void |
setInitialValue(Object newInitialValue) |
有効にする初期値を設定します。ペインが最初に表示されるときにフォーカスを持つ
Componentです。 |
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) |
wantsInputプロパティを設定します。 |
static int |
showConfirmDialog(Component parentComponent, Object message) |
オプション「はい」、「いいえ」、「取消」を含む、「オプションの選択」というタイトルのダイアログを表示します。
|
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パラメータによって決定され、表示するアイコンがmessageTypeパラメータによって決定されるダイアログを表示します。 |
static int |
showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon) |
選択肢の数が
optionTypeパラメータによって決定される、指定されたアイコンを持つダイアログを表示します。 |
static String |
showInputDialog(Component parentComponent, Object message) |
parentComponentを親として、ユーザーからの入力を要求するクエスチョン・メッセージ・ダイアログを表示します。 |
static String |
showInputDialog(Component parentComponent, Object message, Object initialSelectionValue) |
parentComponentを親として、ユーザーからの入力を要求するクエスチョン・メッセージ・ダイアログを表示します。 |
static String |
showInputDialog(Component parentComponent, Object message, String title, int messageType) |
parentComponentを親として、ユーザーからの入力を要求するダイアログを表示します。このダイアログのタイトルはtitleで、メッセージ型はmessageTypeです。 |
static Object |
showInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue) |
初期選択、指定可能な選択項目、およびそれ以外のすべてのオプションの指定が可能なブロッキング・ダイアログでユーザーに入力を求めます。
|
static String |
showInputDialog(Object message) |
ユーザーに入力を求めるクエスチョン・メッセージ・ダイアログを表示します。
|
static String |
showInputDialog(Object message, Object initialSelectionValue) |
ユーザーに入力を求めるクエスチョン・メッセージ・ダイアログを表示します。入力値は
initialSelectionValueに初期化されます。 |
static int |
showInternalConfirmDialog(Component parentComponent, Object message) |
オプション「はい」、「いいえ」、および「取消」を含む、「オプションの選択」というタイトルの内部ダイアログ・パネルを表示します。
|
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パラメータで選択項目数が決まる内部ダイアログ・パネルを表示します。表示するアイコンはmessageTypeパラメータで決まります。 |
static int |
showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon) |
指定されたアイコンを持つ内部ダイアログ・パネルを表示します。選択項目数は
optionTypeパラメータで決まります。 |
static String |
showInternalInputDialog(Component parentComponent, Object message) |
parentComponentを親として、ユーザーに入力を求める内部クエスチョン・メッセージ・ダイアログを表示します。 |
static String |
showInternalInputDialog(Component parentComponent, Object message, String title, int messageType) |
parentComponentを親として、ユーザーからの入力を要求する内部ダイアログを表示します。このダイアログのタイトルはtitleで、メッセージ型はmessageTypeです。 |
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) |
指定されたアイコンを持つ内部ダイアログ・パネルを表示します。初期選択は
initialValueパラメータ、選択項目数はoptionTypeパラメータで決まります。 |
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) |
最初の選択が
initialValueパラメータによって決定され、選択肢の数がoptionTypeパラメータによって決定される、指定されたアイコンを持つダイアログを表示します。 |
void |
updateUI() |
L&Fが変更されたことを示す、
UIManagerからの通知です。 |
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, updateadd, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTreeaction, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCyclepublic static final Object UNINITIALIZED_VALUE
public static final int DEFAULT_OPTION
JOptionPaneのオプションだけを使用します。public static final int YES_NO_OPTION
showConfirmDialogに使用されている型。public static final int YES_NO_CANCEL_OPTION
showConfirmDialogに使用されている型。public static final int OK_CANCEL_OPTION
showConfirmDialogに使用されている型。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
CANCEL_OPTIONまたはNO_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 INITIAL_VALUE_PROPERTY
initialValueのバウンド・プロパティ名です。public static final String MESSAGE_TYPE_PROPERTY
typeのバウンド・プロパティ名です。public static final String OPTION_TYPE_PROPERTY
optionTypeのバウンド・プロパティ名です。public static final String SELECTION_VALUES_PROPERTY
selectionValuesのバウンド・プロパティ名です。public static final String INITIAL_SELECTION_VALUE_PROPERTY
initialSelectionValueのバウンド・プロパティ名です。public static final String INPUT_VALUE_PROPERTY
inputValueのバウンド・プロパティ名です。public static final String WANTS_INPUT_PROPERTY
wantsInputのバウンド・プロパティ名です。protected transient Icon icon
protected transient Object message
protected transient Object[] options
protected transient Object initialValue
optionsで初期状態で選択される値です。protected int messageType
protected int optionType
DEFAULT_OPTION、YES_NO_OPTION、YES_NO_CANCEL_OPTION、またはOK_CANCEL_OPTIONのどれかのオプションの型です。protected transient Object value
UNINITIALIZED_VALUEまたはnullです。protected transient Object[] selectionValues
protected transient Object inputValue
protected transient Object initialSelectionValue
selectionValuesで選択する初期値です。protected boolean wantsInput
public JOptionPane()
JOptionPaneを生成します。public JOptionPane(Object message)
JOptionPaneのインスタンスを生成します。message - 表示するObjectpublic JOptionPane(Object message, int messageType)
JOptionPaneのインスタンスを生成します。message - 表示するObjectmessageType - 表示されるメッセージの種類。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、またはPLAIN_MESSAGEpublic JOptionPane(Object message, int messageType, int optionType)
JOptionPaneのインスタンスを生成します。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)
JOptionPaneのインスタンスを生成します。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)
JOptionPaneのインスタンスを生成します。 初期状態で選択されているオプションはありません。
オプション・オブジェクトには、直接登録されるComponent、またはJButton内にラップされるStringsのどちらかのインスタンスを格納する必要があります。 Componentを提供する場合は、Componentがクリックされたときに、生成されたJOptionPaneでそれがsetValueに通知することを保証する必要があります。
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イメージoptions - ユーザーが選択可能な項目public JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options, Object initialValue)
JOptionPaneのインスタンスを生成します。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イメージoptions - ユーザーが選択可能な項目initialValue - 初期状態で選択されている項目。nullの場合、初期状態では何も選択されていない。optionsが使用される場合にだけ意味を持つpublic static String showInputDialog(Object message) throws HeadlessException
message - 表示するObjectHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public static String showInputDialog(Object message, Object initialSelectionValue)
initialSelectionValueに初期化されます。 ダイアログのフレームはデフォルトです。通常は画面の中央に表示されます。 message - 表示するObjectinitialSelectionValue - 入力フィールドの初期化に使用する値public static String showInputDialog(Component parentComponent, Object message) throws HeadlessException
parentComponentを親として、ユーザーからの入力を要求するクエスチョン・メッセージ・ダイアログを表示します。 ダイアログは、Componentのフレームの上に表示され、通常はComponentの下に配置されます。 parentComponent - ダイアログの親Componentmessage - 表示するObjectHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public static String showInputDialog(Component parentComponent, Object message, Object initialSelectionValue)
parentComponentを親として、ユーザーからの入力を要求するクエスチョン・メッセージ・ダイアログを表示します。 入力値はinitialSelectionValueに初期化されます。 ダイアログは、Componentのフレームの上に表示され、通常はComponentの下に配置されます。 parentComponent - ダイアログの親Componentmessage - 表示するObjectinitialSelectionValue - 入力フィールドの初期化に使用する値public static String showInputDialog(Component parentComponent, Object message, String title, int messageType) throws HeadlessException
parentComponentを親として、ユーザーからの入力を要求するダイアログを表示します。このダイアログのタイトルはtitleで、メッセージ型はmessageTypeです。parentComponent - ダイアログの親Componentmessage - 表示するObjecttitle - ダイアログのタイトル・バーに表示するStringmessageType - 表示されるメッセージの種類。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、またはPLAIN_MESSAGEHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public static Object showInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue) throws HeadlessException
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 - 入力フィールドの初期化に使用する値nullの場合はユーザーが入力を取り消したことを意味するHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public static void showMessageDialog(Component parentComponent, Object message) throws HeadlessException
parentComponent - ダイアログを表示するFrameを指定する。nullの場合、またはparentComponentにFrameがない場合は、デフォルトのFrameが使用されるmessage - 表示するObjectHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType) throws HeadlessException
messageTypeパラメータによって決定されるデフォルト・アイコンを使用して、メッセージを表示するダイアログを表示します。parentComponent - ダイアログを表示するFrameを指定する。nullの場合、またはparentComponentにFrameがない場合は、デフォルトのFrameが使用されるmessage - 表示するObjecttitle - ダイアログのタイトル文字列messageType - 表示されるメッセージの種類。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、またはPLAIN_MESSAGEHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon) throws HeadlessException
parentComponent - ダイアログを表示するFrameを指定する。nullの場合、またはparentComponentにFrameがない場合は、デフォルトのFrameが使用されるmessage - 表示するObjecttitle - ダイアログのタイトル文字列messageType - 表示されるメッセージの種類。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、またはPLAIN_MESSAGEicon - 表示されるメッセージの種類をユーザーが認識しやすくするために、ダイアログに表示するアイコンHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public static int showConfirmDialog(Component parentComponent, Object message) throws HeadlessException
parentComponent - ダイアログを表示するFrameを指定する。nullの場合、またはparentComponentにFrameがない場合は、デフォルトのFrameが使用されるmessage - 表示するObjectHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType) throws HeadlessException
optionTypeパラメータによって決定されるダイアログを表示します。parentComponent - ダイアログを表示するFrameを指定する。nullの場合、またはparentComponentにFrameがない場合は、デフォルトのFrameが使用されるmessage - 表示するObjecttitle - ダイアログのタイトル文字列optionType - ダイアログで選択可能なオプションを示すint値。YES_NO_OPTION、YES_NO_CANCEL_OPTION、またはOK_CANCEL_OPTIONHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType) throws HeadlessException
optionTypeパラメータによって決定され、表示するアイコンがmessageTypeパラメータによって決定されるダイアログを表示します。 ルック・アンド・フィールのデフォルト・アイコンを提示するには、主にmessageTypeパラメータを使用します。 parentComponent - ダイアログを表示するFrameを指定する。nullの場合、またはparentComponentにFrameがない場合は、デフォルトのFrameが使用される。message - 表示するObjecttitle - ダイアログのタイトル文字列optionType - ダイアログで選択可能なオプションを示す整数。YES_NO_OPTION、YES_NO_CANCEL_OPTION、またはOK_CANCEL_OPTIONmessageType - 主にプラグイン可能なルック・アンド・フィールのアイコンを指定するために使用される、メッセージの種類を表す整数。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、またはPLAIN_MESSAGEHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon) throws HeadlessException
optionTypeパラメータによって決定される、指定されたアイコンを持つダイアログを表示します。 ルック・アンド・フィールのデフォルト・アイコンを提示するには、主にmessageTypeパラメータを使用します。 parentComponent - ダイアログを表示するFrameを指定する。nullの場合、またはparentComponentにFrameがない場合は、デフォルトのFrameが使用されるmessage - 表示するObjecttitle - ダイアログのタイトル文字列optionType - ダイアログで選択可能なオプションを示すint値。YES_NO_OPTION、YES_NO_CANCEL_OPTION、またはOK_CANCEL_OPTIONmessageType - 主にプラグイン可能なルック・アンド・フィールのアイコンを指定するために使用される、メッセージの種類を表す整数。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、またはPLAIN_MESSAGEicon - ダイアログに表示するアイコンHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public static int showOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue) throws HeadlessException
initialValueパラメータによって決定され、選択肢の数がoptionTypeパラメータによって決定される、指定されたアイコンを持つダイアログを表示します。
optionTypeがYES_NO_OPTIONまたはYES_NO_CANCEL_OPTIONでoptionsパラメータがnullの場合、オプションはルック・アンド・フィールによって提供されます。
ルック・アンド・フィールのデフォルト・アイコンを提示するには、主にmessageTypeパラメータを使用します。
parentComponent - ダイアログを表示するFrameを指定する。nullの場合、またはparentComponentにFrameがない場合は、デフォルトのFrameが使用されるmessage - 表示するObjecttitle - ダイアログのタイトル文字列optionType - ダイアログで選択可能なオプションを示す整数。DEFAULT_OPTION、YES_NO_OPTION、YES_NO_CANCEL_OPTION、またはOK_CANCEL_OPTIONmessageType - 主にプラグイン可能なルック・アンド・フィールのアイコンを指定するために使用される、メッセージの種類を表す整数。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、またはPLAIN_MESSAGEicon - ダイアログに表示するアイコンoptions - ユーザーが選択可能な項目を示すオブジェクトの配列。オブジェクトがコンポーネントの場合は適切にレンダリングされる。String以外のオブジェクトはtoStringメソッドを使用してレンダリングされる。このパラメータがnullの場合、オプションはルック・アンド・フィールで決まるinitialValue - ダイアログのデフォルト選択を示すオブジェクト。optionsが使用される場合にだけ意味を持つ。nullの場合もあるCLOSED_OPTIONHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public JDialog createDialog(Component parentComponent, String title) throws HeadlessException
parentComponentのフレーム内のparentComponentの中央にthisをラップしている新しいJDialogを作成して返します。titleは返されるダイアログのタイトルです。 返されるJDialogは、ユーザーがサイズを変更することはできませんが、プログラムではJDialogインスタンスでsetResizableを呼び出すことによってこのプロパティを変更できます。 返されるJDialogは、一度閉じるかまたはユーザーがボタンのいずれかをクリックすると、オプション・ペインの値プロパティがそれに応じて設定されてダイアログが閉じるようにします。 ダイアログは、可視にされるたびに、オプション・ペインの値プロパティをJOptionPane.UNINITIALIZED_VALUEにリセットし、ユーザーの後続のアクションによってダイアログが適切に閉じられるようにします。 parentComponent - ダイアログを表示するFrameを指定する。parentComponentにFrameがない場合は、デフォルトのFrameが使用されるtitle - ダイアログのタイトル文字列JDialogHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()public JDialog createDialog(String title) throws HeadlessException
JDialogを作成し、返します。 返されるJDialogは、ユーザーがサイズを変更することはできませんが、プログラムではJDialogインスタンスでsetResizableを呼び出すことによってこのプロパティを変更できます。 返されるJDialogは、一度閉じるかまたはユーザーがボタンのいずれかをクリックすると、オプション・ペインの値プロパティがそれに応じて設定されてダイアログが閉じるようにします。 ダイアログは、可視にされるたびに、オプション・ペインの値プロパティをJOptionPane.UNINITIALIZED_VALUEにリセットし、ユーザーの後続のアクションによってダイアログが適切に閉じられるようにします。 title - ダイアログのタイトル文字列JDialogHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合GraphicsEnvironment.isHeadless()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)
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 - ダイアログで選択可能なオプションを示す整数。YES_NO_OPTION、またはYES_NO_CANCEL_OPTIONpublic static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)
optionTypeパラメータで選択項目数が決まる内部ダイアログ・パネルを表示します。表示するアイコンはmessageTypeパラメータで決まります。 ルック・アンド・フィールのデフォルト・アイコンを提示するには、主にmessageTypeパラメータを使用します。 parentComponent - ダイアログを表示するFrameを指定する。nullの場合、またはparentComponentにFrameがない場合は、デフォルトのFrameが使用されるmessage - ダイアログに表示するオブジェクト。ComponentオブジェクトはComponentとしてレンダリングされる。Stringオブジェクトは文字列としてレンダリングされる。それ以外のオブジェクトはtoStringメソッドでStringに変換されるtitle - ダイアログのタイトル文字列optionType - ダイアログで選択可能なオプションを示す整数。YES_NO_OPTION、またはYES_NO_CANCEL_OPTIONmessageType - 主にプラグイン可能なルック・アンド・フィールのアイコンを指定するために使用される、メッセージの種類を表す整数。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パラメータで決まります。 ルック・アンド・フィールのデフォルト・アイコンを提示するには、主にmessageTypeパラメータを使用します。 parentComponent - ダイアログを表示するFrameを指定する。nullの場合、またはparentComponentにFrameがない場合は、デフォルトのFrameが使用されるmessage - ダイアログに表示するオブジェクト。ComponentオブジェクトはComponentとしてレンダリングされる。Stringオブジェクトは文字列としてレンダリングされる。それ以外のオブジェクトはtoStringメソッドでStringに変換されるtitle - ダイアログのタイトル文字列optionType - ダイアログで選択可能なオプションを示す整数。YES_NO_OPTION、またはYES_NO_CANCEL_OPTION。messageType - 主にプラグイン可能なルック・アンド・フィールのアイコンを指定するために使用される、メッセージの種類を表す整数。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の場合、オプションはルック・アンド・フィールによって提供されます。
ルック・アンド・フィールのデフォルト・アイコンを提示するには、主にmessageTypeパラメータを使用します。
parentComponent - ダイアログを表示するFrameを指定する。nullの場合、またはparentComponentにFrameがない場合は、デフォルトのFrameが使用されるmessage - ダイアログに表示するオブジェクト。ComponentオブジェクトはComponentとしてレンダリングされる。Stringオブジェクトは文字列としてレンダリングされる。 それ以外のオブジェクトはtoStringメソッドでStringに変換される title - ダイアログのタイトル文字列optionType - ダイアログで選択可能なオプションを示す整数。YES_NO_OPTION、またはYES_NO_CANCEL_OPTIONmessageType - 主にプラグイン可能なルック・アンド・フィールのアイコンを指定するために使用される、メッセージの種類を表す整数。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、またはPLAIN_MESSAGEicon - ダイアログに表示するアイコンoptions - ユーザーが選択可能な項目を示すオブジェクトの配列。オブジェクトがコンポーネントの場合は適切にレンダリングされる。String以外のオブジェクトはtoStringメソッドを使用してレンダリングされる。このパラメータがnullの場合、オプションはルック・アンド・フィールで決まるinitialValue - ダイアログのデフォルト選択を示すオブジェクト。optionsが使用される場合にだけ意味を持つ。nullの場合もあるCLOSED_OPTIONpublic 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 - ダイアログの親Componentmessage - 表示するObjecttitle - ダイアログのタイトル・バーに表示するStringmessageType - 表示されるメッセージの種類。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 - 内部フレームの親Componenttitle - フレームのタイトル・バーに表示されるStringJOptionPaneが格納されているJInternalFrameRuntimeException - parentComponentが有効な親を持っていない場合public static Frame getFrameForComponent(Component parentComponent) throws HeadlessException
Frameを返します。parentComponent - Frameを調べるComponentFrame。コンポーネントがnullの場合、または有効なFrameの親を持たない場合はgetRootFrameHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合getRootFrame(), GraphicsEnvironment.isHeadless()public static JDesktopPane getDesktopPaneForComponent(Component parentComponent)
parentComponent - デスクトップを調べるComponentJDesktopPane。コンポーネントがnullの場合、またはJInternalFrameの上位オブジェクトを持たない場合はnullpublic static void setRootFrame(Frame newRootFrame)
ノート: このメソッドを使用する代わりに、有効な親を指定することをお勧めします。
newRootFrame - 使用するデフォルトのFramepublic static Frame getRootFrame() throws HeadlessException
Frameを返します。FrameHeadlessException - GraphicsEnvironment.isHeadlessがtrueを返す場合setRootFrame(java.awt.Frame), GraphicsEnvironment.isHeadless()public void setUI(OptionPaneUI ui)
ui - OptionPaneUI L&FオブジェクトUIDefaults.getUI(javax.swing.JComponent)public OptionPaneUI getUI()
OptionPaneUIオブジェクトpublic void updateUI()
UIManagerからの通知です。 現在のUIオブジェクトをUIManagerの最新バージョンに置き換えます。 updateUI、クラスJComponentJComponent.updateUI()public String getUIClassID()
getUIClassID、クラスJComponentJComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)public void setMessage(Object newMessage)
newMessage - 表示するObjectgetMessage()public Object getMessage()
ObjectsetMessage(java.lang.Object)public void setIcon(Icon newIcon)
nullでない場合、ルック・アンド・フィールはアイコンを提供しません。 newIcon - 表示するIcongetIcon()public Icon getIcon()
IconsetIcon(javax.swing.Icon)public void setValue(Object newValue)
newValue - 選択した値getValue()public Object getValue()
UNINITIALIZED_VALUEはユーザーがまだ選択していないことを、nullはユーザーが何も選択せずにウィンドウを閉じたことを示します。 それ以外の戻り値は、このオブジェクトで定義されるオプションのいずれかです。 Object。ユーザーがまだ選択を実行していない場合はUNINITIALIZED_VALUE、ユーザーが選択を実行しないでウィンドウを閉じた場合はnullsetValue(java.lang.Object)public void setOptions(Object[] newOptions)
newOptions内の要素がComponentの場合は、ペインに直接登録されます。そうでない場合は、要素に対してボタンが作成されます。 newOptions - ユーザーのクリックが可能なボタンを作成するObjectsの配列、またはペインに追加する任意のComponentsgetOptions()public Object[] getOptions()
Objectsの配列setOptions(java.lang.Object[])public void setInitialValue(Object newInitialValue)
Componentです。newInitialValue - 初期キーボード・フォーカスを取得するObjectgetInitialValue()public Object getInitialValue()
ObjectsetInitialValue(java.lang.Object)public void setMessageType(int newType)
parentComponentのレイアウト方法もこれによって決定されます。 newType - 表示するメッセージの種類を指定する整数値。ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE、またはPLAIN_MESSAGERuntimeException - newTypeが上記の正当な値のどれでもない場合getMessageType()public int getMessageType()
setMessageType(int)public void setOptionType(int newType)
newType - L&Fが表示するオプションを示す整数。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)
null値は、通常JTextFieldを使用して、ユーザーがどのような値でも入力できることを示します。
wantsInputをtrueに設定します。 setInitialSelectionValueを使用して初期選択値を指定します。 ペインが有効になると、inputValueはユーザーが選択した値に設定されます。
newValues - 表示するObjectsの配列で、ユーザーはこの中から選択できる。通常はリスト形式またはコンボボックス形式setWantsInput(boolean), setInitialSelectionValue(java.lang.Object), getSelectionValues()public Object[] getSelectionValues()
Objectsの配列setSelectionValues(java.lang.Object[])public void setInitialSelectionValue(Object newValue)
wantsInputがtrueの場合にだけ使用されます。 newValue - 初期選択値setSelectionValues(java.lang.Object[]), getInitialSelectionValue()public Object getInitialSelectionValue()
public void setInputValue(Object newValue)
wantsInputがtrueの場合にだけ使用されます。 このメソッドはオプション・ペインにより(ユーザー・アクションへの応答で)内部的に呼び出され、通常はクライアント・プログラムによって呼び出されることはありません。 初期選択値としてユーザーに対し表示される入力値を設定するには、setInitialSelectionValueを使用します。 newValue - (通常はテキスト・フィールド内で)ユーザーが指定した値の設定に必要なObjectsetSelectionValues(java.lang.Object[]), setInitialSelectionValue(java.lang.Object), setWantsInput(boolean), getInputValue()public Object getInputValue()
wantsInputがtrueの場合に、ユーザーが入力した値を返します。Object、フィールドに入力された値の場合はStringsetSelectionValues(java.lang.Object[]), setWantsInput(boolean), setInputValue(java.lang.Object)public int getMaxCharactersPerLineCount()
Integer.MAX_VALUEを返します。 この値を変更するには、サブクラスでこのメソッドをオーバーライドします。 public void setWantsInput(boolean newValue)
wantsInputプロパティを設定します。 newValueがtrueの場合は、ユーザーが値を入力できるように、parentComponentが親である入力コンポーネント(テキスト・フィールドやコンボボックスなど)が提供されます。 入力値は、getSelectionValuesがnull以外の配列を返す場合はその配列内のオブジェクトのいずれかです。 そうでない場合はユーザーが入力した値です。
これはバウンド・プロパティです。
public boolean getWantsInput()
wantsInputプロパティの値を返します。setWantsInput(boolean)public void selectInitialValue()
protected String paramString()
JOptionPaneの文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。 返される文字列は空の場合がありますが、nullにはなりません。 paramString、クラスJComponentJOptionPaneの文字列表現public AccessibleContext getAccessibleContext()
AccessibleContextを返します。 オプション・ペインの場合、AccessibleContextはAccessibleJOptionPaneの形式を取ります。 必要に応じて、新しいAccessibleJOptionPaneインスタンスが作成されます。 getAccessibleContext、インタフェースAccessiblegetAccessibleContext、クラスComponent バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。