JOptionPane (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.swing
类 JOptionPane

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

所有已实现的接口：: ImageObserver, MenuContainer, Serializable, Accessible

public class JOptionPane
extends JComponent
implements Accessible
extends JComponent
implements Accessible

JOptionPane 有助于方便地弹出要求用户提供值或向其发出通知的标准对话框。有关使用 JOptionPane 的信息，请参见 The Java Tutorial 中的 How to Make Dialogs 一节。

虽然由于方法数多使 JOptionPane 类可能显得复杂，但几乎所有此类的使用都是对下列静态 showXxxDialog 方法之一的单行调用：

方法名描述

showConfirmDialog 询问一个确认问题，如 yes/no/cancel。

showInputDialog 提示要求某些输入。

showMessageDialog 告知用户某事已发生。

showOptionDialog 上述三项的大统一 (Grand Unification)。

方法名	描述
showConfirmDialog	询问一个确认问题，如 yes/no/cancel。
showInputDialog	提示要求某些输入。
showMessageDialog	告知用户某事已发生。
showOptionDialog	上述三项的大统一 (Grand Unification)。

所有这些方法还可能以 showInternalXXX 风格出现，该风格使用内部窗体来保存对话框（请参见 JInternalFrame）。此外还定义了多种便捷方法，这些方法重载那些基本方法，使用不同的参数列表。

所有对话框都是有模式的。在用户交互完成之前，每个 showXxxDialog 方法都一直阻塞调用者。

图标消息

输入值

选项按钮

这些对话框的基本外形通常与右图类似，尽管各种外观从根本上决定着最后结果。尤其是，外观可以调整布局以适应选项窗格的 ComponentOrientation 属性。

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

parentComponent
定义作为此对话框的父对话框的 Component。通过两种方式使用此参数：包含它的 Frame 可以用作对话框的父 Frame，在对话框的位置使用其屏幕坐标。一般情况下，将对话框紧靠组件置于其之下。此参数可以为 null，在这种情况下，默认的 Frame 用作父级，并且对话框将居中位于屏幕上（取决于 L&F）。
message
要置于对话框中的描述消息。在最常见的应用中，message 就是一个 String 或 String 常量。不过，此参数的类型实际上是 Object。其解释依赖于其类型：

Object[]
对象数组被解释为在纵向堆栈中排列的一系列 message（每个对象一个）。解释是递归式的，即根据其类型解释数组中的每个对象。
Component
该 Component 在对话框中显示。
Icon
该 Icon 被包装在 JLabel 中并在对话框中显示。
其他
该对象通过调用其 toString 方法被转换为 String。结果被包装在 JLabel 中显示。

messageType
定义 message 的样式。外观管理器根据此值对对话框进行不同地布置，并且通常提供默认图标。可能的值为：

ERROR_MESSAGE
INFORMATION_MESSAGE
WARNING_MESSAGE
QUESTION_MESSAGE
PLAIN_MESSAGE

optionType
定义在对话框的底部显示的选项按钮的集合：

DEFAULT_OPTION
YES_NO_OPTION
YES_NO_CANCEL_OPTION
OK_CANCEL_OPTION
用户并非仅限于使用此选项按钮集合。使用 options 参数可以提供想使用的任何按钮。
options
将在对话框底部显示的选项按钮集合的更详细描述。options 参数的常规值是 String 数组，但是参数类型是 Object 数组。根据对象的以下类型为每个对象创建一个按钮：

Component
该组件被直接添加到按钮行中。
Icon
创建的 JButton 以此图标作为其标签。
其他
该 Object 通过使用其 toString 方法转换为字符串，并使用该结果作为 JButton 的标签。

icon
要置于对话框中的装饰性图标。图标的默认值由 messageType 参数确定。
title
对话框的标题。
initialValue
默认选择（输入值）。

当选择更改时，调用生成 PropertyChangeEvent 的 setValue 方法。

如果已为所有输入 setWantsInput 配置了 JOptionPane，则还可以侦听绑定属性 JOptionPane.INPUT_VALUE_PROPERTY，以确定何时用户输入或选择了值。

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

YES_OPTION
NO_OPTION
CANCEL_OPTION
OK_OPTION
CLOSED_OPTION

示例：

显示一个错误对话框，该对话框显示的 message 为 'alert'：

JOptionPane.showMessageDialog(null, "alert", "alert", JOptionPane.ERROR_MESSAGE);

显示一个内部信息对话框，其 message 为 'information'：

JOptionPane.showInternalMessageDialog(frame, "information",

             "information", JOptionPane.INFORMATION_MESSAGE);

显示一个信息面板，其 options 为 "yes/no"，message 为 'choose one'：

JOptionPane.showConfirmDialog(null,
             "choose one", "choose one", JOptionPane.YES_NO_OPTION);

显示一个内部信息对话框，其 options 为 "yes/no/cancel"，message 为 'please choose one'，并具有 title 信息：

JOptionPane.showInternalConfirmDialog(frame,
             "please choose one", "information",
             JOptionPane.YES_NO_CANCEL_OPTION, JOptionPane.INFORMATION_MESSAGE);

显示一个警告对话框，其 options 为 OK、CANCEL，title 为 'Warning'，message 为 'Click OK to continue'：

Object[] options = { "OK", "CANCEL" };
 JOptionPane.showOptionDialog(null, "Click OK to continue", "Warning",
             JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE,
             null, options, options[0]);

显示一个要求用户键入 String 的对话框：

String inputValue = JOptionPane.showInputDialog("Please input a value");

显示一个要求用户选择 String 的对话框：

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（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

另请参见：: JInternalFrame

嵌套类摘要

protected class JOptionPane.AccessibleJOptionPane
          此类实现对 JOptionPane 类的可访问性支持。

从类 javax.swing.JComponent 继承的嵌套类/接口

JComponent.AccessibleJComponent

从类 java.awt.Container 继承的嵌套类/接口

Container.AccessibleAWTContainer

从类 java.awt.Component 继承的嵌套类/接口

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
          意味着外观不应该提供任何选项的类型，即仅使用取自 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 时从类方法返回的值。

从类 javax.swing.JComponent 继承的字段

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

从类 java.awt.Component 继承的字段

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

从接口 java.awt.image.ImageObserver 继承的字段

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

JOptionPane()
          创建一个带有测试消息的 JOptionPane。

JOptionPane(Object message)
          创建一个显示消息的 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 的实例，使其具有指定的消息类型、图标和选项。

方法摘要

JDialog createDialog(Component parentComponent, String title)
          创建并返回一个新 JDialog，它在 parentComponent 窗体中的 parentComponent 中央包装 this。

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()
          返回要置于消息的行中的最大字符数。

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)
          调出带有选项 Yes、No 和 Cancel 的对话框；标题为 Select an Option。

static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType)
          调出一个由 optionType 参数确定其中选项数的对话框。

static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)
          调用一个由 optionType 参数确定其中选项数的对话框，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)
          调出带有选项 Yes、No 和 Cancel 的内部对话框面板；标题为 Select an Option。

static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType)
          调出一个由 optionType 参数确定其中选项数的内部对话框面板。

static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)
          调出一个由 optionType 参数确定其中选项数的内部对话框面板，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 为父级。

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 参数确定的默认图标的 message。

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 已改变的通知。

从类 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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

从类 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, transferFocusBackward, transferFocusDownCycle, validate, validateTree

从类 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, hide, 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, transferFocusUpCycle

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

嵌套类摘要
`protected class`	`JOptionPane.AccessibleJOptionPane` 此类实现对 `JOptionPane` 类的可访问性支持。

从类 javax.swing.JComponent 继承的嵌套类/接口
`JComponent.AccessibleJComponent`

从类 java.awt.Container 继承的嵌套类/接口
`Container.AccessibleAWTContainer`

从类 java.awt.Component 继承的嵌套类/接口
`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` 意味着外观不应该提供任何选项的类型，即仅使用取自 `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 时从类方法返回的值。

从类 javax.swing.JComponent 继承的字段
`accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW`

从类 java.awt.Component 继承的字段
`BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT`

从接口 java.awt.image.ImageObserver 继承的字段
`ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH`

构造方法摘要
`JOptionPane()` 创建一个带有测试消息的 `JOptionPane`。
`JOptionPane(Object message)` 创建一个显示消息的 `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` 的实例，使其具有指定的消息类型、图标和选项。

方法摘要
`JDialog`	`createDialog(Component parentComponent, String title)` 创建并返回一个新 `JDialog`，它在 `parentComponent` 窗体中的 `parentComponent` 中央包装 `this`。
`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()` 返回要置于消息的行中的最大字符数。
`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)` 调出带有选项 Yes、No 和 Cancel 的对话框；标题为 Select an Option。
`static int`	`showConfirmDialog(Component parentComponent, Object message, String title, int optionType)` 调出一个由 `optionType` 参数确定其中选项数的对话框。
`static int`	`showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)` 调用一个由 `optionType` 参数确定其中选项数的对话框，`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)` 调出带有选项 Yes、No 和 Cancel 的内部对话框面板；标题为 Select an Option。
`static int`	`showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType)` 调出一个由 `optionType` 参数确定其中选项数的内部对话框面板。
`static int`	`showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)` 调出一个由 `optionType` 参数确定其中选项数的内部对话框面板，`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` 为父级。
`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` 参数确定的默认图标的 message。
`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 已改变的通知。

从类 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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

从类 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, transferFocusBackward, transferFocusDownCycle, validate, validateTree

从类 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, hide, 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, transferFocusUpCycle

从类 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

意味着外观不应该提供任何选项的类型，即仅使用取自 JOptionPane 的选项。

另请参见：: 常量字段值

YES_NO_OPTION

public static final int YES_NO_OPTION

用于 showConfirmDialog 的类型。

另请参见：: 常量字段值

YES_NO_CANCEL_OPTION

public static final int YES_NO_CANCEL_OPTION

用于 showConfirmDialog 的类型。

另请参见：: 常量字段值

OK_CANCEL_OPTION

public static final int OK_CANCEL_OPTION

用于 showConfirmDialog 的类型。

另请参见：: 常量字段值

YES_OPTION

public static final int YES_OPTION

选择 YES 时从类方法返回的值。

另请参见：: 常量字段值

NO_OPTION

public static final int NO_OPTION

选择 NO 时从类方法返回的值。

另请参见：: 常量字段值

CANCEL_OPTION

public static final int CANCEL_OPTION

选择 CANCEL 时从类方法返回的值。

另请参见：: 常量字段值

OK_OPTION

public static final int OK_OPTION

选择 OK 时从类方法返回的值。

另请参见：: 常量字段值

CLOSED_OPTION

public static final int CLOSED_OPTION

用户没有做出任何选择而关闭了窗口时从类方法返回的值，很可能将此值视为 CANCEL_OPTION 或 NO_OPTION。

另请参见：: 常量字段值

ERROR_MESSAGE

public static final int ERROR_MESSAGE

用于错误消息。

另请参见：: 常量字段值

INFORMATION_MESSAGE

public static final int INFORMATION_MESSAGE

用于信息消息。

另请参见：: 常量字段值

WARNING_MESSAGE

public static final int WARNING_MESSAGE

用于警告消息。

另请参见：: 常量字段值

QUESTION_MESSAGE

public static final int QUESTION_MESSAGE

用于问题。

另请参见：: 常量字段值

PLAIN_MESSAGE

public static final int PLAIN_MESSAGE

未使用图标。

另请参见：: 常量字段值

ICON_PROPERTY

public static final String ICON_PROPERTY

icon 的绑定属性名。

另请参见：: 常量字段值

MESSAGE_PROPERTY

public static final String MESSAGE_PROPERTY

message 的绑定属性名。

另请参见：: 常量字段值

VALUE_PROPERTY

public static final String VALUE_PROPERTY

value 的绑定属性名。

另请参见：: 常量字段值

OPTIONS_PROPERTY

public static final String OPTIONS_PROPERTY

option 的绑定属性名。

另请参见：: 常量字段值

INITIAL_VALUE_PROPERTY

public static final String INITIAL_VALUE_PROPERTY

initialValue 的绑定属性名。

另请参见：: 常量字段值

MESSAGE_TYPE_PROPERTY

public static final String MESSAGE_TYPE_PROPERTY

type 的绑定属性名。

另请参见：: 常量字段值

OPTION_TYPE_PROPERTY

public static final String OPTION_TYPE_PROPERTY

optionType 的绑定属性名。

另请参见：: 常量字段值

SELECTION_VALUES_PROPERTY

public static final String SELECTION_VALUES_PROPERTY

selectionValues 的绑定属性名。

另请参见：: 常量字段值

INITIAL_SELECTION_VALUE_PROPERTY

public static final String INITIAL_SELECTION_VALUE_PROPERTY

initialSelectionValue 的绑定属性名。

另请参见：: 常量字段值

INPUT_VALUE_PROPERTY

public static final String INPUT_VALUE_PROPERTY

inputValue 的绑定属性名。

另请参见：: 常量字段值

WANTS_INPUT_PROPERTY

public static final String WANTS_INPUT_PROPERTY

wantsInput 的绑定属性名。

另请参见：: 常量字段值

icon

protected transient Icon icon

在窗格中使用的图标。

message

protected transient Object message

要显示的消息。

options

protected transient Object[] options

要向用户显示的选项。

initialValue

protected transient Object initialValue

应该在 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 的实例，使其具有指定的消息类型、图标和选项。最初没有选择任何选项。

options 对象应该包含 Component（直接添加的）或 String（包装在 JButton 中）的实例。如果提供 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 - 用户可以选择的选项

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 为父级。输入值将被初始化为 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 表示用户可以输入想输入的任何内容，通常依靠 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 数组; initialSelectionValue - 用于初始化输入字段的值
返回：: 用户输入；返回 null 意味着用户取消了输入
抛出：: HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 true
另请参见：: GraphicsEnvironment.isHeadless()

showMessageDialog

public static void showMessageDialog(Component parentComponent,
                                     Object message)
                              throws HeadlessException

调出标题为 "Message" 的信息消息对话框。

参数：: 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 参数确定的默认图标的 message。

参数：: 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

调出带有选项 Yes、No 和 Cancel 的对话框；标题为 Select an Option。

参数：: 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 - 要显示的 Object; 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，它在 parentComponent 窗体中的 parentComponent 中央包装 this。title 是返回对话框的标题。用户不能调整返回的 JDialog，但是程序可以通过调用 JDialog 实例上的 setResizable 来更改此属性。返回的 JDialog 将被设置为：一旦将其关闭或者用户单击其中一个按钮，就会相应地设置选项窗格的值属性并关闭对话框。每次对话框变得可见时，它会将选项窗格的值属性重置为 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 将被设置为：一旦将其关闭或者用户单击其中一个按钮，就会相应地设置选项窗格的值属性并关闭对话框。每次对话框变得可见时，它会将选项窗格的值属性重置为 JOptionPane.UNINITIALIZED_VALUE，从而确保用户的后续动作能够正确地关闭对话框。

参数：: title - 对话框的标题字符串
返回：: 包含此实例的新 JDialog
抛出：: HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 true
从以下版本开始：: 1.6
另请参见：: GraphicsEnvironment.isHeadless()

showInternalMessageDialog

public static void showInternalMessageDialog(Component parentComponent,
                                             Object message)

调出内部确认对话框面板。该对话框是一个信息消息对话框，标题为 "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)

调出带有选项 Yes、No 和 Cancel 的内部对话框面板；标题为 Select an Option。

参数：: 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; 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; 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; 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，则由外观提供选项。

messageType 参数主要用于提供来自外观的默认图标。

参数：: parentComponent - 确定在其中显示对话框的 Frame；如果为 null 或者 parentComponent 不具有 Frame，则使用默认的 Frame; message - 要在对话框中显示的对象；Component 对象呈现为 Component；String 对象呈现为字符串。其他对象通过 toString 方法被转换为 String; title - 对话框的标题字符串; optionType - 指定可用于对话框的选项的整数：YES_NO_OPTION 或 YES_NO_CANCEL_OPTION; messageType - 指定消息种类的整数；主要用于确定来自可插入外观的图标：ERROR_MESSAGE、INFORMATION_MESSAGE、WARNING_MESSAGE、QUESTION_MESSAGE 或 PLAIN_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 表示用户可以输入想输入的任何内容，通常依靠 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 数组; initialSelectionValue - 用于初始化输入字段的值
返回：: 用户输入；返回 null 意味着用户取消了输入

createInternalFrame

public JInternalFrame createInternalFrame(Component parentComponent,
                                          String title)

创建并返回 JInternalFrame 的实例。内部窗体是利用指定标题创建的，同时包装了 JOptionPane。返回的 JInternalFrame 将被添加到 parentComponent 的 JDesktopPane 祖先中；如果其祖先之一不是 JDesktopPane，则添加到其父组件中；如果 parentComponent 不具有父级，则抛出 RuntimeException。

参数：: parentComponent - 内部窗体的父 Component; title - 要在窗体的标题栏中显示的 String
返回：: 包含 JOptionPane 的 JInternalFrame
抛出：: RuntimeException - 如果 parentComponent 不具有有效的父级

getFrameForComponent

public static Frame getFrameForComponent(Component parentComponent)
                                  throws HeadlessException

返回指定组件的 Frame。

参数：: parentComponent - 要检查 Frame 的 Component
返回：: 包含组件的 Frame；如果组件为 null 或者不具有有效的 Frame 父级，则返回 getRootFrame
抛出：: HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 true
另请参见：: getRootFrame(), GraphicsEnvironment.isHeadless()

getDesktopPaneForComponent

public static JDesktopPane getDesktopPaneForComponent(Component parentComponent)

返回指定组件的桌面窗格。

参数：: parentComponent - 要检查桌面的 Component
返回：: 包含组件的 JDesktopPane；如果组件为 null 或者不具有作为 JInternalFrame 的祖先，则返回 null

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 发出的关于 L&F 已改变的通知。根据 UIManager 的最新通知替换当前的 UI 对象。

覆盖：: 类 JComponent 中的 updateUI

另请参见：: JComponent.updateUI()

getUIClassID

public String getUIClassID()

返回实现此组件 L&F 的 UI 类的名称。

覆盖：: 类 JComponent 中的 getUIClassID

返回：: 字符串 "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 - 用于创建用户可单击按钮的 Object 数组，或者要添加到窗格的任意 Component
另请参见：: getOptions()

getOptions

public Object[] getOptions()

返回用户可以作出的选择。

返回：: 给出用户选择的 Object 数组
另请参见：: setOptions(java.lang.Object[])

setInitialValue

public void setInitialValue(Object newInitialValue)

设置要启用的初始值，即最初显示窗格时处于焦点状态的 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)

设置要显示的选项。选项类型供外观确定要显示的按钮时使用（除非已提供选项）。

参数：: 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 值表示用户可以输入想输入的任何值，通常依靠 JTextField 来实现。

将 wantsInput 设置为 true。使用 setInitialSelectionValue 指定最初选择的值。启用了窗格后，inputValue 将被设置为用户所选的值。

参数：: newValues - 用户要显示的 Object 数组（通常使用列表或组合框的形式），用户可以从中作出选择
另请参见：: setWantsInput(boolean), setInitialSelectionValue(java.lang.Object), getSelectionValues()

getSelectionValues

public Object[] getSelectionValues()

返回输入选择值。

返回：: 用户可以选择的 Object 数组
另请参见：: setSelectionValues(java.lang.Object[])

setInitialSelectionValue

public void setInitialSelectionValue(Object newValue)

设置（根据选择）最初向用户显示的输入值。仅当 wantsInput 为 true 时使用。

参数：: 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 为 true 时才使用。注意，此方法由选项窗格内部调用（响应用户操作），客户端程序一般不能调用。要设置（根据选择）最初向用户显示的输入值，请使用 setInitialSelectionValue。

参数：: newValue - 用于设置用户指定值的 Object（通常使用文本字段的形式）
另请参见：: setSelectionValues(java.lang.Object[]), setInitialSelectionValue(java.lang.Object), setWantsInput(boolean), getInputValue()

getInputValue

public Object getInputValue()

如果 wantsInput 为 true，则返回用户已输入的值。

返回：: 用户指定的 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 为 true，则提供其父级为 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 的字符串表示形式。此方法仅在进行调试的时候使用，对于各个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

覆盖：: 类 JComponent 中的 paramString

返回：: 此 JOptionPane 的字符串表示形式

getAccessibleContext

public AccessibleContext getAccessibleContext()

返回与此 JOptionPane 相关联的 AccessibleContext。对于选项窗格，AccessibleContext 采用 AccessibleJOptionPane 的形式。必要时创建一个新的 AccessibleJOptionPane 实例。

指定者：: 接口 Accessible 中的 getAccessibleContext
覆盖：: 类 JComponent 中的 getAccessibleContext

返回：: 一个 AccessibleJOptionPane，它充当此 AccessibleJOptionPane 的 AccessibleContext

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

图标	消息
	输入值
选项按钮

JOptionPane (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

javax.swing 类 JOptionPane

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

showInternalMessageDialog

showInternalConfirmDialog

showInternalConfirmDialog

showInternalConfirmDialog

showInternalConfirmDialog

showInternalOptionDialog

showInternalInputDialog

showInternalInputDialog

showInternalInputDialog

createInternalFrame

getFrameForComponent

getDesktopPaneForComponent

setRootFrame

getRootFrame

setUI

getUI

javax.swing
类 JOptionPane