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
- メッセージのスタイルを定義します。Look & Feelマネージャは、この値に応じてダイアログを個別に配置し、通常はデフォルトのアイコンを用意します。返される値は次のどれかになります。
ERROR_MESSAGE
INFORMATION_MESSAGE
WARNING_MESSAGE
QUESTION_MESSAGE
PLAIN_MESSAGE
- optionType
- ダイアログ・ボックスの下部に表示されるオプション・ボタンのセットを定義します。
使用できるのはこれらのオプション・ボタンにかぎりません。optionsパラメータを使用して任意のボタンを指定することができます。
DEFAULT_OPTION
YES_NO_OPTION
YES_NO_CANCEL_OPTION
OK_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(tm)用の長期間の格納サポートがjava.beans
パッケージに追加されています。XMLEncoder
を参照してください。
JInternalFrame
修飾子と型 | クラスと説明 |
---|---|
protected class |
JOptionPane.AccessibleJOptionPane
このクラスは
JOptionPane クラスのアクセシビリティ・サポートを実装しています。 |
JComponent.AccessibleJComponent
Container.AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
修飾子と型 | フィールドと説明 |
---|---|
static int |
CANCEL_OPTION
「CANCEL」が選択された場合にクラス・メソッドから返される値です。
|
static int |
CLOSED_OPTION
ユーザーが何も選択せずにウィンドウを閉じた場合にクラス・メソッドから返される値です。多くの場合は
CANCEL_OPTION またはNO_OPTION として処理されます。 |
static int |
DEFAULT_OPTION
Look & Feelを意味する型はオプションを提供しません。
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_WINDOW
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
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 を作成して返します。 |
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, update
add, 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, validateTree
action, 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, transferFocusUpCycle
public 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
- 表示するObject
public JOptionPane(Object message, int messageType)
JOptionPane
のインスタンスを生成します。message
- 表示するObject
messageType
- 表示されるメッセージの種類。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
public JOptionPane(Object message, int messageType, int optionType)
JOptionPane
のインスタンスを生成します。message
- 表示するObject
messageType
- 表示されるメッセージの種類。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
optionType
- ペインに表示するオプション。DEFAULT_OPTION
, YES_NO_OPTION
, YES_NO_CANCEL_OPTION
, OK_CANCEL_OPTION
public JOptionPane(Object message, int messageType, int optionType, Icon icon)
JOptionPane
のインスタンスを生成します。message
- 表示するObject
messageType
- 表示されるメッセージの種類。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
optionType
- ペインに表示するオプション。DEFAULT_OPTION
, YES_NO_OPTION
, YES_NO_CANCEL_OPTION
, OK_CANCEL_OPTION
icon
- 表示するIcon
イメージpublic JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options)
JOptionPane
のインスタンスを生成します。初期状態で選択されているオプションはありません。
オプション・オブジェクトには、直接登録されるComponent
、またはJButton
内にラップされるStrings
のどちらかのインスタンスを格納する必要があります。Component
を提供する場合は、Component
がクリックされたときに、生成されたJOptionPane
でそれがsetValue
に通知することを保証する必要があります。
message
- 表示するObject
messageType
- 表示されるメッセージの種類。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
optionType
- ペインに表示するオプション。DEFAULT_OPTION
, YES_NO_OPTION
, YES_NO_CANCEL_OPTION
, OK_CANCEL_OPTION
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_MESSAGE
optionType
- ペインに表示するオプション。DEFAULT_OPTION
, YES_NO_OPTION
, YES_NO_CANCEL_OPTION
, OK_CANCEL_OPTION
icon
- 表示するIconイメージoptions
- ユーザーが選択可能な項目initialValue
- 初期状態で選択されている項目。null
の場合、初期状態では何も選択されていない。options
が使用される場合にだけ意味を持つpublic static String showInputDialog(Object message) throws HeadlessException
message
- 表示するObject
HeadlessException
- GraphicsEnvironment.isHeadless
がtrue
を返す場合GraphicsEnvironment.isHeadless()
public static String showInputDialog(Object message, Object initialSelectionValue)
initialSelectionValue
に初期化されます。ダイアログのフレームはデフォルトです。通常は画面の中央に表示されます。message
- 表示するObject
initialSelectionValue
- 入力フィールドの初期化に使用する値public static String showInputDialog(Component parentComponent, Object message) throws HeadlessException
parentComponent
を親として、ユーザーからの入力を要求するクエスチョン・メッセージ・ダイアログを表示します。ダイアログは、Component
のフレームの上に表示され、通常はComponent
の下に配置されます。parentComponent
- ダイアログの親Component
message
- 表示するObject
HeadlessException
- GraphicsEnvironment.isHeadless
がtrue
を返す場合GraphicsEnvironment.isHeadless()
public static String showInputDialog(Component parentComponent, Object message, Object initialSelectionValue)
parentComponent
を親として、ユーザーからの入力を要求するクエスチョン・メッセージ・ダイアログを表示します。入力値はinitialSelectionValue
に初期化されます。ダイアログは、Component
のフレームの上に表示され、通常はComponent
の下に配置されます。parentComponent
- ダイアログの親Component
message
- 表示するObject
initialSelectionValue
- 入力フィールドの初期化に使用する値public static String showInputDialog(Component parentComponent, Object message, String title, int messageType) throws HeadlessException
parentComponent
を親として、ユーザーからの入力を要求するダイアログを表示します。このダイアログのタイトルはtitle
で、メッセージ型はmessageType
です。parentComponent
- ダイアログの親Component
message
- 表示するObject
title
- ダイアログのタイトル・バーに表示するString
messageType
- 表示されるメッセージの種類。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
HeadlessException
- 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
- ダイアログの親Component
message
- 表示するObject
title
- ダイアログのタイトル・バーに表示するString
messageType
- 表示されるメッセージの種類。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
icon
- 表示する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
- 表示するObject
HeadlessException
- 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
- 表示するObject
title
- ダイアログのタイトル文字列messageType
- 表示されるメッセージの種類。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
HeadlessException
- 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
- 表示するObject
title
- ダイアログのタイトル文字列messageType
- 表示されるメッセージの種類。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
icon
- 表示されるメッセージの種類をユーザーが認識しやすくするために、ダイアログに表示するアイコンHeadlessException
- GraphicsEnvironment.isHeadless
がtrue
を返す場合GraphicsEnvironment.isHeadless()
public static int showConfirmDialog(Component parentComponent, Object message) throws HeadlessException
parentComponent
- ダイアログを表示するFrame
を指定する。null
の場合、またはparentComponent
にFrame
がない場合は、デフォルトのFrame
が使用されるmessage
- 表示するObject
HeadlessException
- 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
- 表示するObject
title
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを示すint値。YES_NO_OPTION
、YES_NO_CANCEL_OPTION
、またはOK_CANCEL_OPTION
HeadlessException
- GraphicsEnvironment.isHeadless
がtrue
を返す場合GraphicsEnvironment.isHeadless()
public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType) throws HeadlessException
optionType
パラメータによって決定され、表示するアイコンがmessageType
パラメータによって決定されるダイアログを表示します。Look & Feelのデフォルト・アイコンを提示するには、主にmessageType
パラメータを使用します。parentComponent
- ダイアログを表示するFrame
を指定する。null
の場合、またはparentComponent
にFrame
がない場合は、デフォルトのFrame
が使用される。message
- 表示するObject
title
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを示す整数。YES_NO_OPTION
、YES_NO_CANCEL_OPTION
、またはOK_CANCEL_OPTION
messageType
- 主にプラグイン可能なLook & Feelのアイコンを指定するために使用される、メッセージの種類を表す整数。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
HeadlessException
- GraphicsEnvironment.isHeadless
がtrue
を返す場合GraphicsEnvironment.isHeadless()
public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon) throws HeadlessException
optionType
パラメータによって決定される、指定されたアイコンを持つダイアログを表示します。Look & Feelのデフォルト・アイコンを提示するには、主にmessageType
パラメータを使用します。parentComponent
- ダイアログを表示するFrame
を指定する。null
の場合、またはparentComponent
にFrame
がない場合は、デフォルトのFrame
が使用されるmessage
- 表示するObjecttitle
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを示すint値。YES_NO_OPTION
、YES_NO_CANCEL_OPTION
、またはOK_CANCEL_OPTION
messageType
- 主にプラグイン可能なLook & Feelのアイコンを指定するために使用される、メッセージの種類を表す整数。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
icon
- ダイアログに表示するアイコン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
の場合、オプションはLook & Feelによって提供されます。
Look & Feelのデフォルト・アイコンを提示するには、主にmessageType
パラメータを使用します。
parentComponent
- ダイアログを表示するFrame
を指定する。null
の場合、またはparentComponent
にFrame
がない場合は、デフォルトのFrame
が使用されるmessage
- 表示するObject
title
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを示す整数。DEFAULT_OPTION
、YES_NO_OPTION
、YES_NO_CANCEL_OPTION
、またはOK_CANCEL_OPTION
messageType
- 主にプラグイン可能なLook & Feelのアイコンを指定するために使用される、メッセージの種類を表す整数。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
icon
- ダイアログに表示するアイコンoptions
- ユーザーが選択可能な項目を示すオブジェクトの配列。オブジェクトがコンポーネントの場合は適切にレンダリングされる。String
以外のオブジェクトはtoString
メソッドを使用してレンダリングされる。このパラメータがnull
の場合、オプションはLook & Feelで決まるinitialValue
- ダイアログのデフォルト選択を示すオブジェクト。options
が使用される場合にだけ意味を持つ。null
の場合もあるCLOSED_OPTION
HeadlessException
- 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
- ダイアログのタイトル文字列JDialog
HeadlessException
- GraphicsEnvironment.isHeadless
がtrue
を返す場合GraphicsEnvironment.isHeadless()
public JDialog createDialog(String title) throws HeadlessException
JDialog
を作成し、返します。返されるJDialog
は、ユーザーがサイズを変更することはできませんが、プログラムではJDialog
インスタンスでsetResizable
を呼び出すことによってこのプロパティを変更できます。返されるJDialog
は、一度閉じるかまたはユーザーがボタンのいずれかをクリックすると、オプション・ペインの値プロパティがそれに応じて設定されてダイアログが閉じるようにします。ダイアログは、可視にされるたびに、オプション・ペインの値プロパティをJOptionPane.UNINITIALIZED_VALUE
にリセットし、ユーザーの後続のアクションによってダイアログが適切に閉じられるようにします。title
- ダイアログのタイトル文字列JDialog
HeadlessException
- 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
- 表示するObject
title
- ダイアログのタイトル文字列messageType
- 表示されるメッセージの種類。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
public 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_MESSAGE
icon
- 表示されるメッセージの種類をユーザーが認識しやすくするために、ダイアログに表示するアイコン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_OPTION
public static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)
optionType
パラメータで選択項目数が決まる内部ダイアログ・パネルを表示します。表示するアイコンはmessageType
パラメータで決まります。Look & Feelのデフォルト・アイコンを提示するには、主にmessageType
パラメータを使用します。parentComponent
- ダイアログを表示するFrame
を指定する。null
の場合、またはparentComponent
にFrame
がない場合は、デフォルトのFrame
が使用されるmessage
- ダイアログに表示するオブジェクト。Component
オブジェクトはComponent
としてレンダリングされる。String
オブジェクトは文字列としてレンダリングされる。それ以外のオブジェクトはtoString
メソッドでString
に変換されるtitle
- ダイアログのタイトル文字列optionType
- ダイアログで選択可能なオプションを示す整数。YES_NO_OPTION
、またはYES_NO_CANCEL_OPTION
messageType
- 主にプラグイン可能なLook & Feelのアイコンを指定するために使用される、メッセージの種類を表す整数。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
public 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_OPTION
。messageType
- 主にプラグイン可能なLook & Feelのアイコンを指定するために使用される、メッセージの種類を表す整数。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
icon
- ダイアログに表示するアイコン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_OPTION
messageType
- 主にプラグイン可能なLook & Feelのアイコンを指定するために使用される、メッセージの種類を表す整数。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
icon
- ダイアログに表示するアイコンoptions
- ユーザーが選択可能な項目を示すオブジェクトの配列。オブジェクトがコンポーネントの場合は適切にレンダリングされる。String
以外のオブジェクトはtoString
メソッドを使用してレンダリングされる。このパラメータがnull
の場合、オプションはLook & Feelで決まるinitialValue
- ダイアログのデフォルト選択を示すオブジェクト。options
が使用される場合にだけ意味を持つ。null
の場合もあるCLOSED_OPTION
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_MESSAGE
icon
- 表示する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) throws HeadlessException
Frame
を返します。parentComponent
- Frame
を調べるComponent
Frame
。コンポーネントがnull
の場合、または有効なFrame
の親を持たない場合はgetRootFrame
HeadlessException
- GraphicsEnvironment.isHeadless
がtrue
を返す場合getRootFrame()
, GraphicsEnvironment.isHeadless()
public static JDesktopPane getDesktopPaneForComponent(Component parentComponent)
parentComponent
- デスクトップを調べるComponent
JDesktopPane
。コンポーネントがnull
の場合、またはJInternalFrame
の上位オブジェクトを持たない場合はnull
public static void setRootFrame(Frame newRootFrame)
注: このメソッドを使用する代わりに、有効な親を指定することをお勧めします。
newRootFrame
- 使用するデフォルトのFrame
public static Frame getRootFrame() throws HeadlessException
Frame
を返します。Frame
HeadlessException
- 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
、クラス: JComponent
JComponent.updateUI()
public String getUIClassID()
getUIClassID
、クラス: JComponent
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はアイコンを提供しません。newIcon
- 表示するIcon
getIcon()
public Icon getIcon()
Icon
setIcon(javax.swing.Icon)
public void setValue(Object newValue)
newValue
- 選択した値getValue()
public Object getValue()
UNINITIALIZED_VALUE
はユーザーがまだ選択していないことを、null
はユーザーが何も選択せずにウィンドウを閉じたことを示します。それ以外の戻り値は、このオブジェクトで定義されるオプションのいずれかです。Object
。ユーザーがまだ選択を実行していない場合はUNINITIALIZED_VALUE
、ユーザーが選択を実行しないでウィンドウを閉じた場合はnull
setValue(java.lang.Object)
public void setOptions(Object[] newOptions)
newOptions
内の要素がComponent
の場合は、ペインに直接登録されます。そうでない場合は、要素に対してボタンが作成されます。newOptions
- ユーザーのクリックが可能なボタンを作成するObjects
の配列、またはペインに追加する任意のComponents
getOptions()
public Object[] getOptions()
Objects
の配列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
のレイアウト方法もこれによって決定されます。newType
- 表示するメッセージの種類を指定する整数値。ERROR_MESSAGE
、INFORMATION_MESSAGE
、WARNING_MESSAGE
、QUESTION_MESSAGE
、またはPLAIN_MESSAGE
RuntimeException
- 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_OPTION
RuntimeException
- 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
- (通常はテキスト・フィールド内で)ユーザーが指定した値の設定に必要なObject
setSelectionValues(java.lang.Object[])
, setInitialSelectionValue(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)
wantsInput
プロパティを設定します。newValue
がtrueの場合は、ユーザーが値を入力できるように、parentComponent
が親である入力コンポーネント(テキスト・フィールドやコンボボックスなど)が提供されます。入力値は、getSelectionValues
がnull
以外の配列を返す場合はその配列内のオブジェクトのいずれかです。そうでない場合はユーザーが入力した値です。
これはバウンド・プロパティです。
public boolean getWantsInput()
wantsInput
プロパティの値を返します。setWantsInput(boolean)
public void selectInitialValue()
protected String paramString()
JOptionPane
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。paramString
、クラス: JComponent
JOptionPane
の文字列表現public AccessibleContext getAccessibleContext()
AccessibleContext
を返します。オプション・ペインの場合、AccessibleContext
はAccessibleJOptionPane
の形式を取ります。必要に応じて、新しいAccessibleJOptionPane
インスタンスが作成されます。getAccessibleContext
、インタフェース: Accessible
getAccessibleContext
、クラス: Component
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.