JOptionPane (Java Platform SE 8 )

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JOptionPane

All Implemented Interfaces:: ImageObserver ， MenuContainer ， Serializable ， Accessible

public class JOptionPane
extends JComponent
implements Accessible

JOptionPane可以轻松地弹出一个标准对话框，提示用户获取值或通知他们某些东西。有关使用JOptionPane ，请参阅Java教程中的 How to Make Dialogs 。

虽然JOptionPane类可能会因为大量的方法而复杂化，但几乎所有这些类的使用都是单行调用静态的showXxxDialog方法之一，如下所示：

Method Name 描述

showConfirmDialog Asks a confirming question, like yes/no/cancel.

showInputDialog Prompt for some input.

showMessageDialog Tell the user about something that has happened.

showOptionDialog The Grand Unification of the above three.

Method Name	描述
showConfirmDialog	Asks a confirming question, like yes/no/cancel.
showInputDialog	Prompt for some input.
showMessageDialog	Tell the user about something that has happened.
showOptionDialog	The Grand Unification of the above three.

这些方法中的每一个也都有一个showInternalXXX风格，它使用一个内部框架来保存对话框（参见JInternalFrame ）。还定义了多种便利方法 - 使用不同参数列表的基本方法的重载版本。

所有对话框都是模态的。每个showXxxDialog方法阻止调用者，直到用户的交互完成。

icon message input value option buttons

这些对话框之一的基本外观通常与右图相似，尽管各种外观和感觉最终对最终结果负责。特别地，外观和风格将调整布局以适应选项窗格的ComponentOrientation属性。

参数：
这些方法的参数遵循一致的模式：

parentComponent

Defines the Component that is to be the parent of this dialog box. It is used in two ways: the Frame that contains it is used as the Frame parent for the dialog box, and its screen coordinates are used in the placement of the dialog box. In general, the dialog box is placed just below the component. This parameter may be null, in which case a default Frame is used as the parent, and the dialog will be centered on the screen (depending on the L&F).

message

A descriptive message to be placed in the dialog box. In the most common usage, message is just a String or String constant. However, the type of this parameter is actually Object. Its interpretation depends on its type:

Object[]

An array of objects is interpreted as a series of messages (one per object) arranged in a vertical stack. The interpretation is recursive -- each object in the array is interpreted according to its type.

Component

The Component is displayed in the dialog.

Icon

The Icon is wrapped in a JLabel and displayed in the dialog.

others

The object is converted to a String by calling its toString method. The result is wrapped in a JLabel and displayed.

messageType

Defines the style of the message. The Look and Feel manager may lay out the dialog differently depending on this value, and will often provide a default icon. The possible values are:

ERROR_MESSAGE

INFORMATION_MESSAGE

WARNING_MESSAGE

QUESTION_MESSAGE

PLAIN_MESSAGE

optionType

Defines the set of option buttons that appear at the bottom of the dialog box:

DEFAULT_OPTION

YES_NO_OPTION

YES_NO_CANCEL_OPTION

OK_CANCEL_OPTION

You aren't limited to this set of option buttons. You can provide any buttons you want using the options parameter.

options

A more detailed description of the set of option buttons that will appear at the bottom of the dialog box. The usual value for the options parameter is an array of Strings. But the parameter type is an array of Objects. A button is created for each object depending on its type:

Component

The component is added to the button row directly.

Icon

A JButton is created with this as its label.

other

The Object is converted to a string using its toString method and the result is used to label a JButton.

icon

A decorative icon to be placed in the dialog box. A default value for this is determined by the messageType parameter.

title

The title for the dialog box.

initialValue

The default selection (input value).

当选择改变时， setValue被调用时，其产生PropertyChangeEvent 。

如果一个JOptionPane已配置为全部输入setWantsInput绑定属性JOptionPane.INPUT_VALUE_PROPERTY也可以收听，以确定用户何时输入或选择一个值。

当其中一个showXxxDialog方法返回一个整数时，可能的值为：

YES_OPTION
NO_OPTION
CANCEL_OPTION
OK_OPTION
CLOSED_OPTION

例子：

显示一个错误对话框，显示消息'alert'：

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);

显示一个警告对话框，其中包含选项OK，CANCEL，标题'Warning'和消息'单击OK继续'：

  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

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`JOptionPane.AccessibleJOptionPane` 这个类实现了可访问性支持 `JOptionPane`类。

Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CANCEL_OPTION` 如果选择CANCEL，则从类方法返回值。
`static int`	`CLOSED_OPTION` 如果用户在没有选择任何内容的情况下关闭窗口，则从类方法返回值，这可能被视为 `CANCEL_OPTION`或 `NO_OPTION` 。
`static int`	`DEFAULT_OPTION` 类型意义Look and 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中最初选择的 `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` 如果选择“是”，则从类方法返回值。

Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法
Constructor and Description
`JOptionPane()` 创建一个带有测试消息的 `JOptionPane` 。
`JOptionPane(Object message)` 创建一个 `JOptionPane`的实例，使用简单消息消息类型和UI传递的默认选项来显示消息。
`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`的实例以显示具有指定消息类型，图标和选项的消息，并指定最初选择的选项。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`JDialog`	`createDialog(Component parentComponent, String title)` 创建并返回一个新的 `JDialog`封装 `this`集中在 `parentComponent`的框架上的 `parentComponent` 。
`JDialog`	`createDialog(String title)` 创建并返回具有指定标题的新的无 `JDialog` JDialog。
`JInternalFrame`	`createInternalFrame(Component parentComponent, String title)` 创建并返回一个 `JInternalFrame`的实例。
`AccessibleContext`	`getAccessibleContext()` 返回 `AccessibleContext`与此相关的JOptionPane。
`static JDesktopPane`	`getDesktopPaneForComponent(Component parentComponent)` 返回指定组件的桌面窗格。
`static Frame`	`getFrameForComponent(Component parentComponent)` 返回指定的组件的 `Frame` 。
`Icon`	`getIcon()` 返回此窗格显示的图标。
`Object`	`getInitialSelectionValue()` 返回最初显示为用户的输入值。
`Object`	`getInitialValue()` 返回初始值。
`Object`	`getInputValue()` 返回用户输入的值，如果 `wantsInput`为真。
`int`	`getMaxCharactersPerLineCount()` 返回在消息中放置在行上的最大字符数。
`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`的字符串表示 `JOptionPane` 。
`void`	`selectInitialValue()` 请求选择初始值，将其设置为初始值。
`void`	`setIcon(Icon newIcon)` 设置要显示的图标。
`void`	`setInitialSelectionValue(Object newValue)` 将最初显示为选定的输入值设置为用户。
`void`	`setInitialValue(Object newInitialValue)` 设置要启用的初始值 - `Component`显示窗格时具有焦点的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`为 `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)` 提供一个名为“消息”的信息消息对话框。
`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()` 从通知 `UIManager`的L＆F已经更改。

Methods inherited from class javax.swing.JComponent
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

Methods inherited from class java.awt.Container
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

Methods inherited from class java.awt.Component
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

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细信息
  - UNINITIALIZED_VALUE
```
public static final Object UNINITIALIZED_VALUE
```
    表示用户尚未选择值。
  - DEFAULT_OPTION
```
public static final int DEFAULT_OPTION
```
    类型含义Look and Feel不应提供任何选项 - 只能使用 JOptionPane的选项。
    
    另请参见：
    
    Constant Field Values
  - YES_NO_OPTION
```
public static final int YES_NO_OPTION
```
    类型用于 showConfirmDialog 。
    
    另请参见：
    
    Constant Field Values
  - YES_NO_CANCEL_OPTION
```
public static final int YES_NO_CANCEL_OPTION
```
    类型用于 showConfirmDialog 。
    
    另请参见：
    
    Constant Field Values
  - OK_CANCEL_OPTION
```
public static final int OK_CANCEL_OPTION
```
    类型用于 showConfirmDialog 。
    
    另请参见：
    
    Constant Field Values
  - YES_OPTION
```
public static final int YES_OPTION
```
    如果选择“是”，则从类方法返回值。
    
    另请参见：
    
    Constant Field Values
  - NO_OPTION
```
public static final int NO_OPTION
```
    如果选择NO，则从类方法返回值。
    
    另请参见：
    
    Constant Field Values
  - CANCEL_OPTION
```
public static final int CANCEL_OPTION
```
    如果选择CANCEL，则从类方法返回值。
    
    另请参见：
    
    Constant Field Values
  - OK_OPTION
```
public static final int OK_OPTION
```
    如果选择OK，则返回值表单类方法。
    
    另请参见：
    
    Constant Field Values
  - CLOSED_OPTION
```
public static final int CLOSED_OPTION
```
    如果用户在不选择任何内容的情况下关闭窗口，则从类方法返回值，这可能被视为 CANCEL_OPTION或 NO_OPTION 。
    
    另请参见：
    
    Constant Field Values
  - ERROR_MESSAGE
```
public static final int ERROR_MESSAGE
```
    用于错误消息。
    
    另请参见：
    
    Constant Field Values
  - INFORMATION_MESSAGE
```
public static final int INFORMATION_MESSAGE
```
    用于信息消息。
    
    另请参见：
    
    Constant Field Values
  - WARNING_MESSAGE
```
public static final int WARNING_MESSAGE
```
    用于警告消息。
    
    另请参见：
    
    Constant Field Values
  - QUESTION_MESSAGE
```
public static final int QUESTION_MESSAGE
```
    用于问题。
    
    另请参见：
    
    Constant Field Values
  - PLAIN_MESSAGE
```
public static final int PLAIN_MESSAGE
```
    没有使用图标。
    
    另请参见：
    
    Constant Field Values
  - ICON_PROPERTY
```
public static final String ICON_PROPERTY
```
    绑定属性名称为 icon 。
    
    另请参见：
    
    Constant Field Values
  - MESSAGE_PROPERTY
```
public static final String MESSAGE_PROPERTY
```
    绑定属性名称为 message 。
    
    另请参见：
    
    Constant Field Values
  - VALUE_PROPERTY
```
public static final String VALUE_PROPERTY
```
    绑定属性名称为 value 。
    
    另请参见：
    
    Constant Field Values
  - OPTIONS_PROPERTY
```
public static final String OPTIONS_PROPERTY
```
    绑定属性名称为 option 。
    
    另请参见：
    
    Constant Field Values
  - INITIAL_VALUE_PROPERTY
```
public static final String INITIAL_VALUE_PROPERTY
```
    绑定属性名称为 initialValue 。
    
    另请参见：
    
    Constant Field Values
  - MESSAGE_TYPE_PROPERTY
```
public static final String MESSAGE_TYPE_PROPERTY
```
    绑定属性名称为 type 。
    
    另请参见：
    
    Constant Field Values
  - OPTION_TYPE_PROPERTY
```
public static final String OPTION_TYPE_PROPERTY
```
    绑定属性名称为 optionType 。
    
    另请参见：
    
    Constant Field Values
  - SELECTION_VALUES_PROPERTY
```
public static final String SELECTION_VALUES_PROPERTY
```
    绑定属性名称为 selectionValues 。
    
    另请参见：
    
    Constant Field Values
  - INITIAL_SELECTION_VALUE_PROPERTY
```
public static final String INITIAL_SELECTION_VALUE_PROPERTY
```
    绑定属性名称为 initialSelectionValue 。
    
    另请参见：
    
    Constant Field Values
  - INPUT_VALUE_PROPERTY
```
public static final String INPUT_VALUE_PROPERTY
```
    绑定属性名称为 inputValue 。
    
    另请参见：
    
    Constant Field Values
  - WANTS_INPUT_PROPERTY
```
public static final String WANTS_INPUT_PROPERTY
```
    绑定属性名称为 wantsInput 。
    
    另请参见：
    
    Constant Field Values
  - icon
```
protected transient Icon icon
```
    窗格中使用的图标。
  - message
```
protected transient Object message
```
    消息显示。
  - options
```
protected transient Object[] options
```
    向用户显示的选项。
  - initialValue
```
protected transient Object initialValue
```
    最初应在options中选择的 options 。
  - messageType
```
protected int messageType
```
    消息类型。
  - optionType
```
protected int optionType
```
    选项类型， DEFAULT_OPTION YES_NO_OPTION ， YES_NO_CANCEL_OPTION或 OK_CANCEL_OPTION 。
  - value
```
protected transient Object value
```
    当前选定的值，将是一个有效的选项，或 UNINITIALIZED_VALUE或 null 。
  - selectionValues
```
protected transient Object[] selectionValues
```
    用户可以选择的数组数组。外观将提供UI组件来从中选择。
  - inputValue
```
protected transient Object inputValue
```
    用户输入的价值
  - initialSelectionValue
```
protected transient Object initialSelectionValue
```
    在 selectionValues中选择的初始值。
  - wantsInput
```
protected boolean wantsInput
```
    如果为true，将向用户提供UI小部件以获取输入。
- 构造方法详细信息
  - JOptionPane
```
public JOptionPane()
```
    创建一个带有测试消息的 JOptionPane 。
  - JOptionPane
```
public JOptionPane(Object message)
```
    创建一个 JOptionPane的实例，以使用简单消息消息类型和UI提供的默认选项来显示消息。
    
    参数
    
    message - 要显示的 Object
  - JOptionPane
```
public JOptionPane(Object message,
                   int messageType)
```
    创建一个 JOptionPane的实例以显示具有指定消息类型和默认选项的消息，
    
    参数
    
    message - 要显示的 Object
    
    messageType -要显示的消息的类型： ERROR_MESSAGE ， INFORMATION_MESSAGE ， WARNING_MESSAGE ， QUESTION_MESSAGE ，或 PLAIN_MESSAGE
  - JOptionPane
```
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
  - JOptionPane
```
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图像
  - JOptionPane
```
public JOptionPane(Object message,
                   int messageType,
                   int optionType,
                   Icon icon,
                   Object[] options)
```
    创建一个JOptionPane的实例来显示具有指定消息类型，图标和选项的消息。最初没有选择任何选项。
    选项对象应包含Component s（直接添加）或Strings （其包装在JButton ）的JButton 。如果您提供Component s，您必须确保当Component被点击时，消息setValue在创建的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 - 用户可以选择的选项
  - JOptionPane
```
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 - 要显示的图标图像
    
    options - 用户可以选择的选项
    
    initialValue - 最初选择的选择; 如果null ，那么什么都不会被初始选择; 唯一有意义的，如果options使用
- 方法详细信息
  - showInputDialog
```
public static String showInputDialog(Object message)
                              throws HeadlessException
```
    显示一个请求用户输入的问题消息对话框。对话框使用默认框架，通常意味着它在屏幕上居中。
    
    参数
    
    message - 要显示的 Object
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - showInputDialog
```
public static String showInputDialog(Object message,
                                     Object initialSelectionValue)
```
    显示询问消息对话框，请求用户输入，输入值初始化为initialSelectionValue 。对话框使用默认框架，通常意味着它在屏幕上居中。
    
    参数
    
    message - 要显示的 Object
    
    initialSelectionValue - 用于初始化输入字段的值
    
    从以下版本开始：
    
    1.4
  - showInputDialog
```
public static String showInputDialog(Component parentComponent,
                                     Object message)
                              throws HeadlessException
```
    显示了一个问题消息对话框，要求从父用户输入parentComponent 。被显示在顶部的对话框Component的帧，且通常位于下面Component 。
    
    参数
    
    parentComponent - 该对话框的父级 Component
    
    message - 要显示的 Object
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - showInputDialog
```
public static String showInputDialog(Component parentComponent,
                                     Object message,
                                     Object initialSelectionValue)
```
    显示一个问题消息对话框，请求从用户输入并parentComponent为parentComponent 。输入值将被初始化为initialSelectionValue 。被显示在顶部的对话框Component的帧，且通常位于下面Component 。
    
    参数
    
    parentComponent - 对话框的父级 Component
    
    message - 要显示的 Object
    
    initialSelectionValue - 用于初始化输入字段的值
    
    从以下版本开始：
    
    1.4
  - showInputDialog
```
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()
  - showInputDialog
```
public static Object showInputDialog(Component parentComponent,
                                     Object message,
                                     String title,
                                     int messageType,
                                     Icon icon,
                                     Object[] selectionValues,
                                     Object initialSelectionValue)
                              throws HeadlessException
```
    在阻止对话框中提示用户输入，可以指定初始选择，可能的选择和所有其他选项。用户可以从selectionValues中选择，其中null意味着用户可以通过null输入任何他们想要的JTextField 。 initialSelectionValue是提示用户的初始值。它是由UI决定如何最好地代表selectionValues ，但通常是JComboBox ， JList ，或JTextField将被使用。
    
    参数
    
    parentComponent - 该对话框的父级 Component
    
    message - 要显示的 Object
    
    title - 要显示在对话框标题栏中的 String
    
    messageType -要显示的消息的类型： ERROR_MESSAGE ， INFORMATION_MESSAGE ， WARNING_MESSAGE ， QUESTION_MESSAGE ，或 PLAIN_MESSAGE
    
    icon - 要显示的 Icon图像
    
    selectionValues - 提供可能的选择的 Object s的数组
    
    initialSelectionValue - 用于初始化输入字段的值
    
    结果
    
    用户输入，或 null表示用户取消输入
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - showMessageDialog
```
public static void showMessageDialog(Component parentComponent,
                                     Object message)
                              throws HeadlessException
```
    提供一个名为“消息”的信息消息对话框。
    
    参数
    
    parentComponent -确定Frame在其中显示的对话框; 如果null ，或者如果parentComponent没有Frame ，则使用默认值Frame
    
    message - 要显示的 Object
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - showMessageDialog
```
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()
  - showMessageDialog
```
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()
  - showConfirmDialog
```
public static int showConfirmDialog(Component parentComponent,
                                    Object message)
                             throws HeadlessException
```
    启动对话框，选择是，否和取消 ; 标题为“选择选项” 。
    
    参数
    
    parentComponent -确定Frame在其中显示的对话框; 如果null ，或者如果parentComponent没有Frame ，则使用默认值Frame
    
    message - 要显示的 Object
    
    结果
    
    指示用户选择的选项的整数
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - showConfirmDialog
```
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
    
    结果
    
    指示用户选择的选项的int
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - showConfirmDialog
```
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 - 要显示的 Object
    
    title - 对话框的标题字符串
    
    optionType -一个整数指定对话框上的可用选项： YES_NO_OPTION ， YES_NO_CANCEL_OPTION ，或 OK_CANCEL_OPTION
    
    messageType - 一个指定消息类型的整数; 主要用于确定从所述可插入外观的图标： ERROR_MESSAGE ， INFORMATION_MESSAGE ， WARNING_MESSAGE ， QUESTION_MESSAGE ，或PLAIN_MESSAGE
    
    结果
    
    指示用户选择的选项的整数
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - showConfirmDialog
```
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 - 要显示的对象
    
    title - 对话框的标题字符串
    
    optionType -一个int指定对话框上的可用选项： YES_NO_OPTION ， YES_NO_CANCEL_OPTION ，或 OK_CANCEL_OPTION
    
    messageType -一个int指定消息种类，主要用于确定来自插入外观的图标： ERROR_MESSAGE ， INFORMATION_MESSAGE ， WARNING_MESSAGE ， QUESTION_MESSAGE ，或 PLAIN_MESSAGE
    
    icon - 在对话框中显示的图标
    
    结果
    
    指示用户选择的选项的int
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - showOptionDialog
```
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 - 要显示的 Object
    
    title - 对话框的标题字符串
    
    optionType -一个整数指定对话框上的可用选项： DEFAULT_OPTION ， YES_NO_OPTION ， YES_NO_CANCEL_OPTION ，或 OK_CANCEL_OPTION
    
    messageType -的整数指定消息种类，主要用于确定来自插入外观的图标： ERROR_MESSAGE ， INFORMATION_MESSAGE ， WARNING_MESSAGE ， QUESTION_MESSAGE ，或 PLAIN_MESSAGE
    
    icon - 在对话框中显示的图标
    
    options - 表示用户可能做出的选择的对象数组; 如果对象是组件，则它们被正确地呈现; 非String对象使用其toString方法呈现; 如果此参数为null ，则选项由外观和外观决定
    
    initialValue - 表示对话框的默认选择的对象; 唯一有意义如果options被使用; 可以null
    
    结果
    
    指示用户选择的选项的整数，如果用户关闭对话框， CLOSED_OPTION
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - createDialog
```
public JDialog createDialog(Component parentComponent,
                            String title)
                     throws HeadlessException
```
    创建并返回一个新的JDialog包装this居中于parentComponent在parentComponent的帧。 title是返回对话框的标题。返回JDialog不会由用户调整大小，但是程序可以通过调用setResizable在JDialog实例来更改此属性。返回的JDialog将被设置为一旦关闭，或者用户单击其中一个按钮，则选项框的value属性将被相应地设置，并且对话框将被关闭。每次对话框显示时，它将将选项窗格的value属性重置为JOptionPane.UNINITIALIZED_VALUE ，以确保用户的后续操作正确关闭对话框。
    
    参数
    
    parentComponent - 确定显示对话框的框架; 如果parentComponent没有Frame ，则使用默认值Frame
    
    title - 对话框的标题字符串
    
    结果
    
    一个新的 JDialog包含这个实例
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - createDialog
```
public JDialog createDialog(String title)
                     throws HeadlessException
```
    创建并返回具有指定标题的新的无JDialog JDialog。返回JDialog不会由用户调整大小，但是程序可以通过调用setResizable在JDialog实例来更改此属性。返回的JDialog将被设置为一旦关闭，或者用户单击其中一个按钮，则选项框的value属性将被相应地设置，并且对话框将被关闭。每次对话框显示时，它将将选项窗格的value属性重置为JOptionPane.UNINITIALIZED_VALUE ，以确保用户的后续操作正确关闭对话框。
    
    参数
    
    title - 对话框的标题字符串
    
    结果
    
    一个新的 JDialog包含这个实例
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - showInternalMessageDialog
```
public static void showInternalMessageDialog(Component parentComponent,
                                             Object message)
```
    启动内部确认对话框面板。对话框是一个名为“消息”的信息消息对话框。
    
    参数
    
    parentComponent -确定Frame在其中显示的对话框; 如果null ，或者如果parentComponent没有Frame ，则使用默认值Frame
    
    message - 要显示的对象
  - showInternalMessageDialog
```
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_MESSAGE
  - showInternalMessageDialog
```
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 - 在对话框中显示的图标，帮助用户识别正在显示的消息的种类
  - showInternalConfirmDialog
```
public static int showInternalConfirmDialog(Component parentComponent,
                                            Object message)
```
    启动一个内部对话面板，选择是，否和取消 ; 标题为“选择选项” 。
    
    参数
    
    parentComponent -确定Frame在其中显示的对话框; 如果null ，或者如果parentComponent没有Frame ，则使用默认值Frame
    
    message - 要显示的 Object
    
    结果
    
    指示用户选择的选项的整数
  - showInternalConfirmDialog
```
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为toString
    
    title - 对话框的标题字符串
    
    optionType - 指定对话框中可用选项的整数： YES_NO_OPTION或 YES_NO_CANCEL_OPTION
    
    结果
    
    指示用户选择的选项的整数
  - showInternalConfirmDialog
```
public 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为toString
    
    title - 对话框的标题字符串
    
    optionType - 指定对话框中可用选项的整数： YES_NO_OPTION或 YES_NO_CANCEL_OPTION
    
    messageType -的整数指定消息种类，主要用于确定来自插入外观的图标： ERROR_MESSAGE ， INFORMATION_MESSAGE ， WARNING_MESSAGE ， QUESTION_MESSAGE ，或 PLAIN_MESSAGE
    
    结果
    
    指示用户选择的选项的整数
  - showInternalConfirmDialog
```
public 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为toString
    
    title - 对话框的标题字符串
    
    optionType - 指定对话框中可用选项的整数： YES_NO_OPTION或 YES_NO_CANCEL_OPTION 。
    
    messageType -的整数指定消息种类，主要用于确定来自插入外观的图标： ERROR_MESSAGE ， INFORMATION_MESSAGE ， WARNING_MESSAGE ， QUESTION_MESSAGE ，或 PLAIN_MESSAGE
    
    icon - 在对话框中显示的图标
    
    结果
    
    指示用户选择的选项的整数
  - showInternalOptionDialog
```
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 and Feel提供。
    
    messageType参数主要用于从外观提供默认图标。
    
    参数
    
    parentComponent -确定Frame在其中显示的对话框; 如果null ，或者如果parentComponent没有Frame ，则使用默认值Frame
    
    message - 在对话框中显示的对象; 一个Component对象呈现为Component ; 一个String对象被渲染为一个字符串。其他对象使用toString方法String为toString
    
    title - 对话框的标题字符串
    
    optionType - 指定对话框中可用选项的整数： YES_NO_OPTION或 YES_NO_CANCEL_OPTION
    
    messageType - 一个指定消息类型的整数的整数; 主要用于确定从所述可插入外观的图标： ERROR_MESSAGE ， INFORMATION_MESSAGE ， WARNING_MESSAGE ， QUESTION_MESSAGE ，或PLAIN_MESSAGE
    
    icon - 在对话框中显示的图标
    
    options - 表示用户可能做出的选择的对象数组; 如果对象是组件，则它们被正确地呈现; 非String对象使用他们的toString方法渲染; 如果此参数为null ，则选项由外观和外观决定
    
    initialValue - 表示对话框的默认选择的对象; 唯一有意义如果options被使用; 可以null
    
    结果
    
    指示用户选择的选项的整数，如果用户关闭对话框， CLOSED_OPTION
  - showInternalInputDialog
```
public static String showInternalInputDialog(Component parentComponent,
                                             Object message)
```
    示出了一个内部问题消息对话框请求来自父于用户输入parentComponent 。被显示在该对话框Component的帧，且通常位于下面Component 。
    
    参数
    
    parentComponent - 该对话框的父级 Component
    
    message - 要显示的 Object
  - showInternalInputDialog
```
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_MESSAGE
  - showInternalInputDialog
```
public static Object showInternalInputDialog(Component parentComponent,
                                             Object message,
                                             String title,
                                             int messageType,
                                             Icon icon,
                                             Object[] selectionValues,
                                             Object initialSelectionValue)
```
    在阻止内部对话框中提示输入用户，可以指定初始选择，可能的选择和所有其他选项。用户可以从selectionValues中选择，其中null意味着用户可以通过null输入任何他们想要的JTextField 。 initialSelectionValue是提示用户的初始值。它是由UI决定如何最好地代表selectionValues ，但通常是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意思是用户取消输入
  - createInternalFrame
```
public JInternalFrame createInternalFrame(Component parentComponent,
                                          String title)
```
    创建并返回一个JInternalFrame的实例。内部框架使用指定的标题创建，并包装JOptionPane 。返回的JInternalFrame被添加到JDesktopPane祖先parentComponent ，或组件父对象，如果其祖先不是JDesktopPane ，或者如果parentComponent没有父级，则抛出RuntimeException 。
    
    参数
    
    parentComponent - 内部框架的父级 Component
    
    title - 要显示在框架的标题栏中的 String
    
    结果
    
    一个 JInternalFrame包含一个 JOptionPane
    
    异常
    
    RuntimeException - 如果 parentComponent没有有效的父母
  - getFrameForComponent
```
public static Frame getFrameForComponent(Component parentComponent)
                                  throws HeadlessException
```
    返回指定的组件的 Frame 。
    
    参数
    
    parentComponent - Component检查一个 Frame
    
    结果
    
    该 Frame包含组件，或 getRootFrame如果组件为 null ，或者没有有效 Frame父
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    另请参见：
    
    getRootFrame() ， GraphicsEnvironment.isHeadless()
  - getDesktopPaneForComponent
```
public static JDesktopPane getDesktopPaneForComponent(Component parentComponent)
```
    返回指定组件的桌面窗格。
    
    参数
    
    parentComponent - Component检查桌面
    
    结果
    
    所述 JDesktopPane包含该组件，或 null如果组件是 null或不具有祖先是 JInternalFrame
  - setRootFrame
```
public static void setRootFrame(Frame newRootFrame)
```
    将框架设置为不提供框架的类方法。
    注意：建议您不要使用此方法提供有效的父级。
    
    参数
    
    newRootFrame - 默认使用 Frame
  - getRootFrame
```
public static Frame getRootFrame()
                          throws HeadlessException
```
    返回 Frame用于不提供框架的类方法。
    
    结果
    
    默认使用 Frame
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless返回 true
    
    另请参见：
    
    setRootFrame(java.awt.Frame) ， GraphicsEnvironment.isHeadless()
  - setUI
```
public void setUI(OptionPaneUI ui)
```
    设置实现该组件的L＆F的UI对象。
    
    参数
    
    ui - OptionPaneUI L＆F对象
    
    另请参见：
    
    UIDefaults.getUI(javax.swing.JComponent)
  - getUI
```
public OptionPaneUI getUI()
```
    返回实现该组件的L＆F的UI对象。
    
    结果
    
    OptionPaneUI对象
  - updateUI
```
public void updateUI()
```
    UIManager的UIManager表明L＆F已经发生变化。用UIManager替换最新版本的当前UI对象。
    
    重写：
    
    updateUI在 JComponent
    
    另请参见：
    
    JComponent.updateUI()
  - getUIClassID
```
public String getUIClassID()
```
    返回实现该组件的L＆F的UI类的名称。
    
    重写：
    
    getUIClassID在类 JComponent
    
    结果
    
    字符串“OptionPaneUI”
    
    另请参见：
    
    JComponent.getUIClassID() ， UIDefaults.getUI(javax.swing.JComponent)
  - setMessage
```
public void setMessage(Object newMessage)
```
    设置选项窗格的消息对象。
    
    参数
    
    newMessage - 要显示的 Object
    
    另请参见：
    
    getMessage()
  - getMessage
```
public Object getMessage()
```
    返回窗格显示的消息对象。
    
    结果
    
    该 Object所显示
    
    另请参见：
    
    setMessage(java.lang.Object)
  - setIcon
```
public void setIcon(Icon newIcon)
```
    设置要显示的图标。如果null ，外观和感觉不提供图标。
    
    参数
    
    newIcon - 要显示的 Icon
    
    另请参见：
    
    getIcon()
  - getIcon
```
public Icon getIcon()
```
    返回此窗格显示的图标。
    
    结果
    
    该 Icon所显示
    
    另请参见：
    
    setIcon(javax.swing.Icon)
  - setValue
```
public void setValue(Object newValue)
```
    设置用户选择的值。
    
    参数
    
    newValue - 所选值
    
    另请参见：
    
    getValue()
  - getValue
```
public Object getValue()
```
    返回用户选择的值。 UNINITIALIZED_VALUE意味着用户还没有做出选择， null意味着用户关闭窗口，选择任何东西。否则返回的值将是此对象中定义的选项之一。
    
    结果
    
    该 Object由用户选择 UNINITIALIZED_VALUE如果用户尚未作出一个选择，或 null如果用户关闭了窗口不作选择
    
    另请参见：
    
    setValue(java.lang.Object)
  - setOptions
```
public void setOptions(Object[] newOptions)
```
    设置该窗格显示的选项。如果newOptions中的元素是Component它将直接添加到窗格中，否则将为该元素创建一个按钮。
    
    参数
    
    newOptions - 创建用户可以点击的按钮的 Objects数组，或任意添加到窗格的 Components
    
    另请参见：
    
    getOptions()
  - getOptions
```
public Object[] getOptions()
```
    返回用户可以做出的选择。
    
    结果
    
    Objects的数组给用户的选择
    
    另请参见：
    
    setOptions(java.lang.Object[])
  - setInitialValue
```
public void setInitialValue(Object newInitialValue)
```
    设置要启用的初始值 - Component显示窗格时具有焦点的Component。
    
    参数
    
    newInitialValue - 获得初始键盘焦点的 Object
    
    另请参见：
    
    getInitialValue()
  - getInitialValue
```
public Object getInitialValue()
```
    返回初始值。
    
    结果
    
    获得初始键盘焦点的 Object
    
    另请参见：
    
    setInitialValue(java.lang.Object)
  - setMessageType
```
public void setMessageType(int newType)
```
    设置选项窗格的消息类型。外观和风格使用消息类型来确定要显示的图标（如果没有提供）以及潜在地如何布局parentComponent 。
    
    参数
    
    newType -一个整数，指定的消息种类来显示： ERROR_MESSAGE ， INFORMATION_MESSAGE ， WARNING_MESSAGE ， QUESTION_MESSAGE ，或 PLAIN_MESSAGE
    
    异常
    
    RuntimeException - 如果 newType不是上面列出的合法价值之一
    
    另请参见：
    
    getMessageType()
  - getMessageType
```
public int getMessageType()
```
    返回消息类型。
    
    结果
    
    指定消息类型的整数
    
    另请参见：
    
    setMessageType(int)
  - setOptionType
```
public void setOptionType(int newType)
```
    设置要显示的选项。 Look and Feel使用选项类型来确定要显示的按钮（除非提供选项）。
    
    参数
    
    newType -一个整数，指定的选项的L＆F是显示： DEFAULT_OPTION ， YES_NO_OPTION ， YES_NO_CANCEL_OPTION ，或 OK_CANCEL_OPTION
    
    异常
    
    RuntimeException - 如果 newType不是上面列出的合法价值之一
    
    另请参见：
    
    getOptionType() ， setOptions(java.lang.Object[])
  - getOptionType
```
public int getOptionType()
```
    返回显示的选项类型。
    
    结果
    
    一个指定用户可选择选项的整数
    
    另请参见：
    
    setOptionType(int)
  - setSelectionValues
```
public void setSelectionValues(Object[] newValues)
```
    设置为用户提供可供选择的项目列表的窗格的输入选择值。（UI提供了一个用于选择其中一个值的窗口小部件。） null值意味着用户可以通过null输入任何想要的JTextField 。
    将wantsInput设置为true。使用setInitialSelectionValue指定最初选择的值。窗格启用后， inputValue设置为用户选择的值。
    
    参数
    
    newValues - 要 Objects的用户（通常在列表或组合框中）的用户可以进行选择的数组88514197349035
    
    另请参见：
    
    setWantsInput(boolean) ， setInitialSelectionValue(java.lang.Object) ， getSelectionValues()
  - getSelectionValues
```
public Object[] getSelectionValues()
```
    返回输入选择值。
    
    结果
    
    Objects的阵列 Objects用户选择
    
    另请参见：
    
    setSelectionValues(java.lang.Object[])
  - setInitialSelectionValue
```
public void setInitialSelectionValue(Object newValue)
```
    将最初显示为选定的输入值设置为用户。仅在wantsInput为真时使用。
    
    参数
    
    newValue - 初始选择的值
    
    另请参见：
    
    setSelectionValues(java.lang.Object[]) ， getInitialSelectionValue()
  - getInitialSelectionValue
```
public Object getInitialSelectionValue()
```
    返回最初显示为用户的输入值。
    
    结果
    
    最初选择的值
    
    另请参见：
    
    setInitialSelectionValue(java.lang.Object) ， setSelectionValues(java.lang.Object[])
  - setInputValue
```
public void setInputValue(Object newValue)
```
    设置用户选择或输入的输入值。仅在wantsInput为真时才使用。请注意，此方法由选项窗格（响应于用户操作）内部调用，并且通常不应由客户端程序调用。要将初始显示的输入值设置为选定的用户，请使用setInitialSelectionValue 。
    
    参数
    
    newValue - Object用于设置用户指定的值（通常在文本字段中）
    
    另请参见：
    
    setSelectionValues(java.lang.Object[]) ， setInitialSelectionValue(java.lang.Object) ， setWantsInput(boolean) ， getInputValue()
  - getInputValue
```
public Object getInputValue()
```
    返回用户输入的值，如果 wantsInput为真。
    
    结果
    
    所述 Object用户指定，如果是的对象之一，或 String ，如果它是一个值键入到字段
    
    另请参见：
    
    setSelectionValues(java.lang.Object[]) ， setWantsInput(boolean) ， setInputValue(java.lang.Object)
  - getMaxCharactersPerLineCount
```
public int getMaxCharactersPerLineCount()
```
    返回在消息中放置在行上的最大字符数。默认是返回Integer.MAX_VALUE 。可以通过在子类中覆盖此方法来更改该值。
    
    结果
    
    一个整数，给出一行上的最大字符数
  - setWantsInput
```
public void setWantsInput(boolean newValue)
```
    设置wantsInput属性。如果newValue为真，则提供其父级为parentComponent的输入组件（例如文本字段或组合框），以允许用户输入值。如果getSelectionValues返回非null数组，则输入值是该数组中的一个对象。否则输入值是用户输入的任何值。
    这是一个绑定属性。
    
    另请参见：
    
    setSelectionValues(java.lang.Object[]) ， setInputValue(java.lang.Object)
  - getWantsInput
```
public boolean getWantsInput()
```
    返回 wantsInput属性的值。
    
    结果
    
    如果提供输入组件，则为true
    
    另请参见：
    
    setWantsInput(boolean)
  - selectInitialValue
```
public void selectInitialValue()
```
    请求选择初始值，将其设置为初始值。应该在包含选项窗格的窗口可见后调用此方法。
  - paramString
```
protected String paramString()
```
    返回此JOptionPane的字符串表示JOptionPane 。该方法仅用于调试目的，并且返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空，但可能不是null 。
    
    重写：
    
    paramString在类 JComponent
    
    结果
    
    这个 JOptionPane的字符串表示 JOptionPane
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    返回AccessibleContext与此相关的JOptionPane。对于选项窗格中， AccessibleContext需要一个形式AccessibleJOptionPane 。如果需要，将创建一个新的AccessibleJOptionPane实例。
    
    Specified by:
    
    getAccessibleContext在界面 Accessible
    
    重写：
    
    getAccessibleContext在类 Component
    
    结果
    
    一个AccessibleJOptionPane，用作AccessibleJOptionPane的AccessibleContext

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class JOptionPane

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

构造方法摘要

方法摘要

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

字段详细信息

UNINITIALIZED_VALUE

DEFAULT_OPTION

YES_NO_OPTION

YES_NO_CANCEL_OPTION

OK_CANCEL_OPTION

YES_OPTION

NO_OPTION

CANCEL_OPTION

OK_OPTION

CLOSED_OPTION

ERROR_MESSAGE

INFORMATION_MESSAGE

WARNING_MESSAGE

QUESTION_MESSAGE

PLAIN_MESSAGE

ICON_PROPERTY

MESSAGE_PROPERTY

VALUE_PROPERTY

OPTIONS_PROPERTY

INITIAL_VALUE_PROPERTY

MESSAGE_TYPE_PROPERTY

OPTION_TYPE_PROPERTY

SELECTION_VALUES_PROPERTY

INITIAL_SELECTION_VALUE_PROPERTY

INPUT_VALUE_PROPERTY

WANTS_INPUT_PROPERTY

icon

message

options

initialValue

messageType

optionType

value

selectionValues

inputValue

initialSelectionValue

wantsInput

构造方法详细信息

JOptionPane

JOptionPane

JOptionPane

JOptionPane

JOptionPane

JOptionPane

JOptionPane

方法详细信息

showInputDialog

showInputDialog

showInputDialog

showInputDialog

showInputDialog

showInputDialog

showMessageDialog

showMessageDialog

showMessageDialog

showConfirmDialog

showConfirmDialog

showConfirmDialog

showConfirmDialog

showOptionDialog

createDialog

createDialog

showInternalMessageDialog

showInternalMessageDialog