JOptionPane (GNU libgcj 4.8.0 Documentation)

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
```
This class creates different types of JDialogs and JInternalFrames that can ask users for input or pass on information. JOptionPane can be used by calling one of the show static methods or by creating an instance of JOptionPane and calling createDialog or createInternalFrame.

See Also:
Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

protected class JOptionPane.AccessibleJOptionPane
Provides the accessibility features for the JOptionPane component.
- 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.BltBufferStrategy, Component.FlipBufferStrategy

Nested Classes
Modifier and Type	Class and Description
`protected class`	`JOptionPane.AccessibleJOptionPane` Provides the accessibility features for the `JOptionPane` component.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CANCEL_OPTION` The value returned when cancel option is selected.
`static int`	`CLOSED_OPTION` The value returned when the dialog is closed without a selection.
`static int`	`DEFAULT_OPTION` An option used in confirmation dialog methods.
`static int`	`ERROR_MESSAGE` Identifier for the error message type.
`protected Icon`	`icon` The icon displayed in the dialog/internal frame.
`static String`	`ICON_PROPERTY` The identifier for the propertyChangeEvent when the icon property changes.
`static int`	`INFORMATION_MESSAGE` Identifier for the information message type.
`static String`	`INITIAL_SELECTION_VALUE_PROPERTY` The identifier for the propertyChangeEvent when the initialSelectionValue property changes.
`static String`	`INITIAL_VALUE_PROPERTY` The identifier for the propertyChangeEvent when the initialValue property changes.
`protected Object`	`initialSelectionValue` The initial selected value in the input component.
`protected Object`	`initialValue` The object that is initially selected for options.
`static String`	`INPUT_VALUE_PROPERTY` The identifier for the propertyChangeEvent when the inputValue property changes.
`protected Object`	`inputValue` The value the user inputs.
`protected Object`	`message` The message displayed in the dialog/internal frame.
`static String`	`MESSAGE_PROPERTY` The identifier for the propertyChangeEvent when the message property changes.
`static String`	`MESSAGE_TYPE_PROPERTY` The identifier for the propertyChangeEvent when the messageType property changes.
`protected int`	`messageType` The type of message displayed.
`static int`	`NO_OPTION` The value returned when the no option is selected.
`static int`	`OK_CANCEL_OPTION` An option used in confirmation dialog methods.
`static int`	`OK_OPTION` The value returned when the ok option is selected.
`static String`	`OPTION_TYPE_PROPERTY` The identifier for the propertyChangeEvent when the optionType property changes.
`protected Object[]`	`options` The options (usually buttons) aligned at the bottom for the user to select.
`static String`	`OPTIONS_PROPERTY` The identifier for the propertyChangeEvent when the options property changes.
`protected int`	`optionType` The type of options to display.
`static int`	`PLAIN_MESSAGE` Identifier for the plain message type.
`static int`	`QUESTION_MESSAGE` Identifier for the question message type.
`static String`	`SELECTION_VALUES_PROPERTY` The identifier for the propertyChangeEvent when the selectionValues property changes.
`protected Object[]`	`selectionValues` The input values the user can select.
`static Object`	`UNINITIALIZED_VALUE` The value returned when the inputValue is uninitialized.
`protected Object`	`value` The value returned by selecting an option.
`static String`	`VALUE_PROPERTY` The identifier for the propertyChangeEvent when the value property changes.
`static String`	`WANTS_INPUT_PROPERTY` The identifier for the propertyChangeEvent when the wantsInput property changes.
`protected boolean`	`wantsInput` Whether the Dialog/InternalFrame needs input.
`static int`	`WARNING_MESSAGE` Identifier for the warning message type.
`static int`	`YES_NO_CANCEL_OPTION` An option used in confirmation dialog methods.
`static int`	`YES_NO_OPTION` An option used in confirmation dialog methods.
`static int`	`YES_OPTION` The value returned when the yes option is selected.

Fields inherited from class javax.swing.JComponent
accessibleContext, 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
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 Summary

Constructors
Constructor and Description
`JOptionPane()` Creates a new JOptionPane object using a message of "JOptionPane message", using the PLAIN_MESSAGE type and DEFAULT_OPTION.
`JOptionPane(Object message)` Creates a new JOptionPane object using the given message using the PLAIN_MESSAGE type and DEFAULT_OPTION.
`JOptionPane(Object message, int messageType)` Creates a new JOptionPane object using the given message and messageType and DEFAULT_OPTION.
`JOptionPane(Object message, int messageType, int optionType)` Creates a new JOptionPane object using the given message, messageType and optionType.
`JOptionPane(Object message, int messageType, int optionType, Icon icon)` Creates a new JOptionPane object using the given message, messageType, optionType and icon.
`JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options)` Creates a new JOptionPane object using the given message, messageType, optionType, icon and options.
`JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options, Object initialValue)` Creates a new JOptionPane object using the given message, messageType, optionType, icon, options and initialValue.

Method Summary

Methods
Modifier and Type	Method and Description
`JDialog`	`createDialog(Component parentComponent, String title)` This method creates a new JDialog that is either centered around the parent's frame or centered on the screen (if the parent is null).
`JInternalFrame`	`createInternalFrame(Component parentComponent, String title)` This method creates a new JInternalFrame that is in the JLayeredPane which contains the parentComponent given.
`AccessibleContext`	`getAccessibleContext()` Returns the object that provides accessibility features for this `JOptionPane` component.
`static JDesktopPane`	`getDesktopPaneForComponent(Component parentComponent)` This method returns the JDesktopPane for the given parentComponent or null if none can be found.
`static Frame`	`getFrameForComponent(Component parentComponent)` This method returns the Frame for the given parentComponent or null if none can be found.
`Icon`	`getIcon()` This method returns the icon displayed.
`Object`	`getInitialSelectionValue()` This method returns the value initially selected from the list of values the user can input.
`Object`	`getInitialValue()` This method returns the value that is focused from the list of options.
`Object`	`getInputValue()` This method returns the value that the user input.
`int`	`getMaxCharactersPerLineCount()` This method returns the maximum characters per line.
`Object`	`getMessage()` This method returns the message displayed.
`int`	`getMessageType()` This method returns the message type.
`Object[]`	`getOptions()` This method returns the options.
`int`	`getOptionType()` This method returns the option type.
`static Frame`	`getRootFrame()` This method returns the Frame used by JOptionPane dialog's that have no parent.
`Object[]`	`getSelectionValues()` This method returns the selection values.
`OptionPaneUI`	`getUI()` This method returns the UI used by the JOptionPane.
`String`	`getUIClassID()` This method returns an identifier to determine which UI class will act as the UI.
`Object`	`getValue()` This method returns the value that the user selected out of options.
`boolean`	`getWantsInput()` This method returns whether this JOptionPane wants input.
`protected String`	`paramString()` This method returns a String that describes this JOptionPane.
`void`	`selectInitialValue()` This method requests focus for the initial value.
`void`	`setIcon(Icon newIcon)` This method changes the icon property.
`void`	`setInitialSelectionValue(Object newValue)` This method changes the initial selection property.
`void`	`setInitialValue(Object newValue)` This method changes the initial value property.
`void`	`setInputValue(Object newValue)` This method changes the inputValue property.
`void`	`setMessage(Object newMessage)` This method changes the message property.
`void`	`setMessageType(int newType)` This method changes the messageType property.
`void`	`setOptions(Object[] newOptions)` This method changes the options property.
`void`	`setOptionType(int newType)` This method changes the optionType property.
`static void`	`setRootFrame(Frame newRootFrame)` This method changes the Frame used for JOptionPane dialogs that have no parent.
`void`	`setSelectionValues(Object[] newValues)` This method changes the selectionValues property.
`void`	`setUI(OptionPaneUI ui)` This method sets the UI used with the JOptionPane.
`void`	`setValue(Object newValue)` This method sets the value has been selected out of options.
`void`	`setWantsInput(boolean newValue)` This method changes the wantsInput property.
`static int`	`showConfirmDialog(Component parentComponent, Object message)` This method shows a confirmation dialog with the title "Select an Option" and displays the given message.
`static int`	`showConfirmDialog(Component parentComponent, Object message, String title, int optionType)` This method shows a confirmation dialog with the given message, optionType and title.
`static int`	`showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)` This method shows a confirmation dialog with the given message, title, messageType and optionType.
`static int`	`showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon)` This method shows a confirmation dialog with the given message, title, optionType, messageType and icon.
`static String`	`showInputDialog(Component parentComponent, Object message)` This method will show a QUESTION_MESSAGE input dialog with the given message.
`static String`	`showInputDialog(Component parentComponent, Object message, Object initialSelectionValue)` This method will show a QUESTION_MESSAGE type input dialog with the given message and initialSelectionValue.
`static String`	`showInputDialog(Component parentComponent, Object message, String title, int messageType)` This method displays a new input dialog with the given message, title and messageType.
`static Object`	`showInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue)` This method shows an input dialog with the given message, title, messageType, icon, selectionValues, and initialSelectionValue.
`static String`	`showInputDialog(Object message)` This method shows a QUESTION_MESSAGE type input dialog.
`static String`	`showInputDialog(Object message, Object initialSelectionValue)` This method shows a QUESTION_MESSAGE type input dialog.
`static int`	`showInternalConfirmDialog(Component parentComponent, Object message)` This method shows an internal confirmation dialog with the given message.
`static int`	`showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType)` This method shows an internal confirmation dialog with the given message, optionType and title.
`static int`	`showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)` This method shows an internal confirmation dialog with the given message, title, optionTypes and icon for the given message type.
`static int`	`showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon)` This method shows an internal confirmation dialog with the given message, title, option type, message type, and icon.
`static String`	`showInternalInputDialog(Component parentComponent, Object message)` This method shows an internal input dialog with the given message.
`static String`	`showInternalInputDialog(Component parentComponent, Object message, String title, int messageType)` This method shows an internal input dialog with the given message, title and message type.
`static Object`	`showInternalInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue)` This method shows an internal input dialog with the given message, title message type, icon, selection value list and initial selection value.
`static void`	`showInternalMessageDialog(Component parentComponent, Object message)` This method shows an internal message dialog with the given message.
`static void`	`showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType)` This method shows an internal message dialog with the given message, title and message type.
`static void`	`showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon)` This method shows an internal message dialog with the given message, title, message type and icon.
`static int`	`showInternalOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue)` This method displays an internal option dialog with the given message, title, option type, message type, icon, option list, and initial option value.
`static void`	`showMessageDialog(Component parentComponent, Object message)` This method shows an INFORMATION_MESSAGE type message dialog.
`static void`	`showMessageDialog(Component parentComponent, Object message, String title, int messageType)` This method shows a message dialog with the given message, title and messageType.
`static void`	`showMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon)` This method shows a message dialog with the given message, title, messageType and icon.
`static int`	`showOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue)` This method shows an option dialog with the given message, title, optionType, messageType, icon, options and initialValue.
`void`	`updateUI()` This method resets the UI to the Look and Feel default.

Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, 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, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setNextFocusableComponent, setOpaque, 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, setFocusTraversalKeys, 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, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, 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, processMouseEvent, 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, setMaximumSize, setMinimumSize, setName, setPreferredSize, 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

- Field Detail
  - CANCEL_OPTION
```
public static final int CANCEL_OPTION
```
    The value returned when cancel option is selected.
    
    See Also:
    Constant Field Values
  - CLOSED_OPTION
```
public static final int CLOSED_OPTION
```
    The value returned when the dialog is closed without a selection.
    
    See Also:
    Constant Field Values
  - DEFAULT_OPTION
```
public static final int DEFAULT_OPTION
```
    An option used in confirmation dialog methods.
    
    See Also:
    Constant Field Values
  - NO_OPTION
```
public static final int NO_OPTION
```
    The value returned when the no option is selected.
    
    See Also:
    Constant Field Values
  - OK_CANCEL_OPTION
```
public static final int OK_CANCEL_OPTION
```
    An option used in confirmation dialog methods.
    
    See Also:
    Constant Field Values
  - OK_OPTION
```
public static final int OK_OPTION
```
    The value returned when the ok option is selected.
    
    See Also:
    Constant Field Values
  - YES_NO_CANCEL_OPTION
```
public static final int YES_NO_CANCEL_OPTION
```
    An option used in confirmation dialog methods.
    
    See Also:
    Constant Field Values
  - YES_NO_OPTION
```
public static final int YES_NO_OPTION
```
    An option used in confirmation dialog methods.
    
    See Also:
    Constant Field Values
  - YES_OPTION
```
public static final int YES_OPTION
```
    The value returned when the yes option is selected.
    
    See Also:
    Constant Field Values
  - ERROR_MESSAGE
```
public static final int ERROR_MESSAGE
```
    Identifier for the error message type.
    
    See Also:
    Constant Field Values
  - INFORMATION_MESSAGE
```
public static final int INFORMATION_MESSAGE
```
    Identifier for the information message type.
    
    See Also:
    Constant Field Values
  - PLAIN_MESSAGE
```
public static final int PLAIN_MESSAGE
```
    Identifier for the plain message type.
    
    See Also:
    Constant Field Values
  - QUESTION_MESSAGE
```
public static final int QUESTION_MESSAGE
```
    Identifier for the question message type.
    
    See Also:
    Constant Field Values
  - WARNING_MESSAGE
```
public static final int WARNING_MESSAGE
```
    Identifier for the warning message type.
    
    See Also:
    Constant Field Values
  - ICON_PROPERTY
```
public static final String ICON_PROPERTY
```
    The identifier for the propertyChangeEvent when the icon property changes.
    
    See Also:
    Constant Field Values
  - INITIAL_SELECTION_VALUE_PROPERTY
```
public static final String INITIAL_SELECTION_VALUE_PROPERTY
```
    The identifier for the propertyChangeEvent when the initialSelectionValue property changes.
    
    See Also:
    Constant Field Values
  - INITIAL_VALUE_PROPERTY
```
public static final String INITIAL_VALUE_PROPERTY
```
    The identifier for the propertyChangeEvent when the initialValue property changes.
    
    See Also:
    Constant Field Values
  - INPUT_VALUE_PROPERTY
```
public static final String INPUT_VALUE_PROPERTY
```
    The identifier for the propertyChangeEvent when the inputValue property changes.
    
    See Also:
    Constant Field Values
  - MESSAGE_PROPERTY
```
public static final String MESSAGE_PROPERTY
```
    The identifier for the propertyChangeEvent when the message property changes.
    
    See Also:
    Constant Field Values
  - MESSAGE_TYPE_PROPERTY
```
public static final String MESSAGE_TYPE_PROPERTY
```
    The identifier for the propertyChangeEvent when the messageType property changes.
    
    See Also:
    Constant Field Values
  - OPTION_TYPE_PROPERTY
```
public static final String OPTION_TYPE_PROPERTY
```
    The identifier for the propertyChangeEvent when the optionType property changes.
    
    See Also:
    Constant Field Values
  - OPTIONS_PROPERTY
```
public static final String OPTIONS_PROPERTY
```
    The identifier for the propertyChangeEvent when the options property changes.
    
    See Also:
    Constant Field Values
  - SELECTION_VALUES_PROPERTY
```
public static final String SELECTION_VALUES_PROPERTY
```
    The identifier for the propertyChangeEvent when the selectionValues property changes.
    
    See Also:
    Constant Field Values
  - VALUE_PROPERTY
```
public static final String VALUE_PROPERTY
```
    The identifier for the propertyChangeEvent when the value property changes.
    
    See Also:
    Constant Field Values
  - WANTS_INPUT_PROPERTY
```
public static final String WANTS_INPUT_PROPERTY
```
    The identifier for the propertyChangeEvent when the wantsInput property changes.
    
    See Also:
    Constant Field Values
  - UNINITIALIZED_VALUE
```
public static final Object UNINITIALIZED_VALUE
```
    The value returned when the inputValue is uninitialized.
  - icon
```
protected Icon icon
```
    The icon displayed in the dialog/internal frame.
  - initialSelectionValue
```
protected Object initialSelectionValue
```
    The initial selected value in the input component.
  - initialValue
```
protected Object initialValue
```
    The object that is initially selected for options.
  - inputValue
```
protected Object inputValue
```
    The value the user inputs.
  - message
```
protected Object message
```
    The message displayed in the dialog/internal frame.
  - messageType
```
protected int messageType
```
    The type of message displayed.
  - options
```
protected Object[] options
```
    The options (usually buttons) aligned at the bottom for the user to select.
  - optionType
```
protected int optionType
```
    The type of options to display.
  - selectionValues
```
protected Object[] selectionValues
```
    The input values the user can select.
  - value
```
protected Object value
```
    The value returned by selecting an option.
  - wantsInput
```
protected boolean wantsInput
```
    Whether the Dialog/InternalFrame needs input.
- Constructor Detail
  - JOptionPane
```
public JOptionPane()
```
    Creates a new JOptionPane object using a message of "JOptionPane message", using the PLAIN_MESSAGE type and DEFAULT_OPTION.
  - JOptionPane
```
public JOptionPane(Object message)
```
    Creates a new JOptionPane object using the given message using the PLAIN_MESSAGE type and DEFAULT_OPTION.
    
    Parameters:
    message - The message to display.
  - JOptionPane
```
public JOptionPane(Object message,
           int messageType)
```
    Creates a new JOptionPane object using the given message and messageType and DEFAULT_OPTION.
    
    Parameters:
    message - The message to display.
    messageType - The type of message.
  - JOptionPane
```
public JOptionPane(Object message,
           int messageType,
           int optionType)
```
    Creates a new JOptionPane object using the given message, messageType and optionType.
    
    Parameters:
    message - The message to display.
    messageType - The type of message.
    optionType - The type of options.
  - JOptionPane
```
public JOptionPane(Object message,
           int messageType,
           int optionType,
           Icon icon)
```
    Creates a new JOptionPane object using the given message, messageType, optionType and icon.
    
    Parameters:
    message - The message to display.
    messageType - The type of message.
    optionType - The type of options.
    icon - The icon to display.
  - JOptionPane
```
public JOptionPane(Object message,
           int messageType,
           int optionType,
           Icon icon,
           Object[] options)
```
    Creates a new JOptionPane object using the given message, messageType, optionType, icon and options.
    
    Parameters:
    message - The message to display.
    messageType - The type of message.
    optionType - The type of options.
    icon - The icon to display.
    options - The options given.
  - JOptionPane
```
public JOptionPane(Object message,
           int messageType,
           int optionType,
           Icon icon,
           Object[] options,
           Object initialValue)
```
    Creates a new JOptionPane object using the given message, messageType, optionType, icon, options and initialValue. The initialValue will be focused initially.
    
    Parameters:
    message - The message to display.
    messageType - The type of message.
    optionType - The type of options.
    icon - The icon to display.
    options - The options given.
    initialValue - The component to focus on initially.
    
    Throws:
    
    IllegalArgumentException - If the messageType or optionType are not legal values.
- Method Detail
  - createDialog
```
public JDialog createDialog(Component parentComponent,
                   String title)
```
    This method creates a new JDialog that is either centered around the parent's frame or centered on the screen (if the parent is null). The JDialog will not be resizable and will be modal. Once the JDialog is disposed, the inputValue and value properties will be set by the optionPane.
    
    Parameters:
    parentComponent - The parent of the Dialog.
    title - The title in the bar of the JDialog.
    
    Returns:
    A new JDialog based on the JOptionPane configuration.
  - createInternalFrame
```
public JInternalFrame createInternalFrame(Component parentComponent,
                                 String title)
                                   throws RuntimeException
```
    This method creates a new JInternalFrame that is in the JLayeredPane which contains the parentComponent given. If no suitable JLayeredPane can be found from the parentComponent given, a RuntimeException will be thrown.
    
    Parameters:
    parentComponent - The parent to find a JDesktopPane from.
    title - The title of the JInternalFrame.
    
    Returns:
    A new JInternalFrame based on the JOptionPane configuration.
    
    Throws:
    
    RuntimeException - If no suitable JDesktopPane is found.
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    Returns the object that provides accessibility features for this JOptionPane component.
    
    Specified by:
    
    getAccessibleContext in interface Accessible
    
    Overrides:
    
    getAccessibleContext in class JComponent
    
    Returns:
    The accessible context (an instance of JOptionPane.AccessibleJOptionPane).
  - getDesktopPaneForComponent
```
public static JDesktopPane getDesktopPaneForComponent(Component parentComponent)
```
    This method returns the JDesktopPane for the given parentComponent or null if none can be found.
    
    Parameters:
    parentComponent - The component to look in.
    
    Returns:
    The JDesktopPane for the given component or null if none can be found.
  - getFrameForComponent
```
public static Frame getFrameForComponent(Component parentComponent)
```
    This method returns the Frame for the given parentComponent or null if none can be found.
    
    Parameters:
    parentComponent - The component to look in.
    
    Returns:
    The Frame for the given component or null if none can be found.
  - getIcon
```
public Icon getIcon()
```
    This method returns the icon displayed.
    
    Returns:
    The icon displayed.
  - getInitialSelectionValue
```
public Object getInitialSelectionValue()
```
    This method returns the value initially selected from the list of values the user can input.
    
    Returns:
    The initial selection value.
  - getInitialValue
```
public Object getInitialValue()
```
    This method returns the value that is focused from the list of options.
    
    Returns:
    The initial value from options.
  - getInputValue
```
public Object getInputValue()
```
    This method returns the value that the user input.
    
    Returns:
    The user's input value.
  - getMaxCharactersPerLineCount
```
public int getMaxCharactersPerLineCount()
```
    This method returns the maximum characters per line. By default, this is Integer.MAX_VALUE.
    
    Returns:
    The maximum characters per line.
  - getMessage
```
public Object getMessage()
```
    This method returns the message displayed.
    
    Returns:
    The message displayed.
  - getMessageType
```
public int getMessageType()
```
    This method returns the message type.
    
    Returns:
    The message type.
  - getOptions
```
public Object[] getOptions()
```
    This method returns the options.
    
    Returns:
    The options.
  - getOptionType
```
public int getOptionType()
```
    This method returns the option type.
    
    Returns:
    The option type.
  - getRootFrame
```
public static Frame getRootFrame()
```
    This method returns the Frame used by JOptionPane dialog's that have no parent.
    
    Returns:
    The Frame used by dialogs that have no parent.
  - getSelectionValues
```
public Object[] getSelectionValues()
```
    This method returns the selection values.
    
    Returns:
    The selection values.
  - getUI
```
public OptionPaneUI getUI()
```
    This method returns the UI used by the JOptionPane.
    
    Returns:
    The UI used by the JOptionPane.
  - getUIClassID
```
public String getUIClassID()
```
    This method returns an identifier to determine which UI class will act as the UI.
    
    Overrides:
    
    getUIClassID in class JComponent
    
    Returns:
    The UI identifier.
    See Also:
    JComponent.setUI(javax.swing.plaf.ComponentUI), JComponent.updateUI()
  - getValue
```
public Object getValue()
```
    This method returns the value that the user selected out of options.
    
    Returns:
    The value that the user selected out of options.
  - getWantsInput
```
public boolean getWantsInput()
```
    This method returns whether this JOptionPane wants input.
    
    Returns:
    Whether this JOptionPane wants input.
  - paramString
```
protected String paramString()
```
    This method returns a String that describes this JOptionPane.
    
    Overrides:
    
    paramString in class JComponent
    
    Returns:
    A String that describes this JOptionPane.
  - selectInitialValue
```
public void selectInitialValue()
```
    This method requests focus for the initial value.
  - setIcon
```
public void setIcon(Icon newIcon)
```
    This method changes the icon property.
    
    Parameters:
    newIcon - The new icon to use.
  - setInitialSelectionValue
```
public void setInitialSelectionValue(Object newValue)
```
    This method changes the initial selection property.
    
    Parameters:
    newValue - The new initial selection.
  - setInitialValue
```
public void setInitialValue(Object newValue)
```
    This method changes the initial value property.
    
    Parameters:
    newValue - The new initial value.
  - setInputValue
```
public void setInputValue(Object newValue)
```
    This method changes the inputValue property.
    
    Parameters:
    newValue - The new inputValue.
  - setMessage
```
public void setMessage(Object newMessage)
```
    This method changes the message property.
    
    Parameters:
    newMessage - The new message.
  - setMessageType
```
public void setMessageType(int newType)
```
    This method changes the messageType property.
    
    Parameters:
    newType - The new messageType.
    
    Throws:
    
    IllegalArgumentException - If the messageType is not valid.
  - setOptions
```
public void setOptions(Object[] newOptions)
```
    This method changes the options property.
    
    Parameters:
    newOptions - The new options.
  - setOptionType
```
public void setOptionType(int newType)
```
    This method changes the optionType property.
    
    Parameters:
    newType - The new optionType.
    
    Throws:
    
    IllegalArgumentException - If the optionType is not valid.
  - setRootFrame
```
public static void setRootFrame(Frame newRootFrame)
```
    This method changes the Frame used for JOptionPane dialogs that have no parent.
    
    Parameters:
    newRootFrame - The Frame to use for dialogs that have no parent.
  - setSelectionValues
```
public void setSelectionValues(Object[] newValues)
```
    This method changes the selectionValues property.
    
    Parameters:
    newValues - The new selectionValues.
  - setUI
```
public void setUI(OptionPaneUI ui)
```
    This method sets the UI used with the JOptionPane.
    
    Parameters:
    ui - The UI used with the JOptionPane.
  - setValue
```
public void setValue(Object newValue)
```
    This method sets the value has been selected out of options.
    
    Parameters:
    newValue - The value that has been selected out of options.
  - setWantsInput
```
public void setWantsInput(boolean newValue)
```
    This method changes the wantsInput property.
    
    Parameters:
    newValue - Whether this JOptionPane requires input.
  - showConfirmDialog
```
public static int showConfirmDialog(Component parentComponent,
                    Object message)
```
    This method shows a confirmation dialog with the title "Select an Option" and displays the given message. The parent frame will be the same as the parent frame of the given parentComponent. This method returns the option chosen by the user.
    
    Parameters:
    parentComponent - The parentComponent to find a frame in.
    message - The message to display.
    
    Returns:
    The option that was selected.
  - showConfirmDialog
```
public static int showConfirmDialog(Component parentComponent,
                    Object message,
                    String title,
                    int optionType)
```
    This method shows a confirmation dialog with the given message, optionType and title. The frame that owns the dialog will be the same frame that holds the given parentComponent. This method returns the option that was chosen.
    
    Parameters:
    parentComponent - The component to find a frame in.
    message - The message displayed.
    title - The title of the dialog.
    optionType - The optionType.
    
    Returns:
    The option that was chosen.
  - showConfirmDialog
```
public static int showConfirmDialog(Component parentComponent,
                    Object message,
                    String title,
                    int optionType,
                    int messageType)
```
    This method shows a confirmation dialog with the given message, title, messageType and optionType. The frame owner will be the same frame as the one that holds the given parentComponent. This method returns the option selected by the user.
    
    Parameters:
    parentComponent - The component to find a frame in.
    message - The message displayed.
    title - The title of the dialog.
    optionType - The optionType.
    messageType - The messageType.
    
    Returns:
    The selected option.
  - showConfirmDialog
```
public static int showConfirmDialog(Component parentComponent,
                    Object message,
                    String title,
                    int optionType,
                    int messageType,
                    Icon icon)
```
    This method shows a confirmation dialog with the given message, title, optionType, messageType and icon. The frame owner will be the same as the one that holds the given parentComponent. This method returns the option selected by the user.
    
    Parameters:
    parentComponent - The component to find a frame in.
    message - The message displayed.
    title - The title of the dialog.
    optionType - The optionType.
    messageType - The messsageType.
    icon - The icon displayed.
    
    Returns:
    The selected option.
  - showInputDialog
```
public static String showInputDialog(Component parentComponent,
                     Object message)
```
    This method will show a QUESTION_MESSAGE input dialog with the given message. No selectionValues is set so the Look and Feel will usually give the user a TextField to fill out. The frame owner will be the same frame that holds the given parentComponent. This method will return the value entered by the user.
    
    Parameters:
    parentComponent - The component to find a frame in.
    message - The message displayed.
    
    Returns:
    The value entered by the user.
  - showInputDialog
```
public static String showInputDialog(Component parentComponent,
                     Object message,
                     Object initialSelectionValue)
```
    This method will show a QUESTION_MESSAGE type input dialog with the given message and initialSelectionValue. Since there is no selectionValues set, the Look and Feel will usually give a TextField to fill out. The frame owner will be the same as the one that holds the given parentComponent. This method will return the value entered by the user.
    
    Parameters:
    parentComponent - The component to find a frame in.
    message - The message to display.
    initialSelectionValue - The initially selected value.
    
    Returns:
    The value the user input.
  - showInputDialog
```
public static String showInputDialog(Component parentComponent,
                     Object message,
                     String title,
                     int messageType)
```
    This method displays a new input dialog with the given message, title and messageType. Since no selectionValues value is given, the Look and Feel will usually give the user a TextField to input data to. This method returns the value the user inputs.
    
    Parameters:
    parentComponent - The component to find a frame in.
    message - The message to display.
    title - The title of the dialog.
    messageType - The messageType.
    
    Returns:
    The value the user input.
  - showInputDialog
```
public static Object showInputDialog(Component parentComponent,
                     Object message,
                     String title,
                     int messageType,
                     Icon icon,
                     Object[] selectionValues,
                     Object initialSelectionValue)
```
    This method shows an input dialog with the given message, title, messageType, icon, selectionValues, and initialSelectionValue. This method returns the value that the user selects.
    
    Parameters:
    parentComponent - The component to find a frame in.
    message - The message displayed.
    title - The title of the dialog.
    messageType - The messageType.
    icon - The icon displayed.
    selectionValues - The list of values to select from.
    initialSelectionValue - The initially selected value.
    
    Returns:
    The user selected value.
  - showInputDialog
```
public static String showInputDialog(Object message)
```
    This method shows a QUESTION_MESSAGE type input dialog. Since no selectionValues is set, the Look and Feel will usually give the user a TextField to input data to. This method returns the value the user inputs.
    
    Parameters:
    message - The message to display.
    
    Returns:
    The user selected value.
  - showInputDialog
```
public static String showInputDialog(Object message,
                     Object initialSelectionValue)
```
    This method shows a QUESTION_MESSAGE type input dialog. Since no selectionValues is set, the Look and Feel will usually give the user a TextField to input data to. The input component will be initialized with the initialSelectionValue. This method returns the value the user inputs.
    
    Parameters:
    message - The message to display.
    initialSelectionValue - The initialSelectionValue.
    
    Returns:
    The user selected value.
  - showInternalConfirmDialog
```
public static int showInternalConfirmDialog(Component parentComponent,
                            Object message)
```
    This method shows an internal confirmation dialog with the given message. The internal frame dialog will be placed in the first JDesktopPane ancestor of the given parentComponent. This method will return the value selected.
    
    Parameters:
    parentComponent - The parent to find a JDesktopPane in.
    message - The message to display.
    
    Returns:
    The value selected.
  - showInternalConfirmDialog
```
public static int showInternalConfirmDialog(Component parentComponent,
                            Object message,
                            String title,
                            int optionType)
```
    This method shows an internal confirmation dialog with the given message, optionType and title. The internal frame dialog will be placed in the first JDesktopPane ancestor of the given parentComponent. This method will return the selected value.
    
    Parameters:
    parentComponent - The parent to find a JDesktopPane in.
    message - The message to display.
    title - The title to display.
    optionType - The option type.
    
    Returns:
    The selected value.
  - showInternalConfirmDialog
```
public static int showInternalConfirmDialog(Component parentComponent,
                            Object message,
                            String title,
                            int optionType,
                            int messageType)
```
    This method shows an internal confirmation dialog with the given message, title, optionTypes and icon for the given message type. The internal confirmation dialog will be placed in the first instance of JDesktopPane ancestor of the given parentComponent.
    
    Parameters:
    parentComponent - The component to find a JDesktopPane in.
    message - The message to display.
    title - The title of the dialog.
    optionType - The option type.
    messageType - The message type.
    
    Returns:
    The selected value.
  - showInternalConfirmDialog
```
public static int showInternalConfirmDialog(Component parentComponent,
                            Object message,
                            String title,
                            int optionType,
                            int messageType,
                            Icon icon)
```
    This method shows an internal confirmation dialog with the given message, title, option type, message type, and icon. The internal frame dialog will be placed in the first JDesktopPane ancestor that is found in the given parentComponent. This method returns the selected value.
    
    Parameters:
    parentComponent - The parent to find a JDesktopPane in.
    message - The message to display.
    title - The title to display.
    optionType - The option type.
    messageType - The message type.
    icon - The icon to display.
    
    Returns:
    The selected value.
  - showInternalInputDialog
```
public static String showInternalInputDialog(Component parentComponent,
                             Object message)
```
    This method shows an internal input dialog with the given message. The internal frame dialog will be placed in the first JDesktopPane ancestor of the given parent component. This method returns the value input by the user.
    
    Parameters:
    parentComponent - The parent to find a JDesktopPane in.
    message - The message to display.
    
    Returns:
    The user selected value.
  - showInternalInputDialog
```
public static String showInternalInputDialog(Component parentComponent,
                             Object message,
                             String title,
                             int messageType)
```
    This method shows an internal input dialog with the given message, title and message type. The internal input dialog will be placed in the first JDesktopPane ancestor found in the given parent component. This method will return the input value given by the user.
    
    Parameters:
    parentComponent - The component to find a JDesktopPane in.
    message - The message to display.
    title - The title to display.
    messageType - The message type.
    
    Returns:
    The user input value.
  - showInternalInputDialog
```
public static Object showInternalInputDialog(Component parentComponent,
                             Object message,
                             String title,
                             int messageType,
                             Icon icon,
                             Object[] selectionValues,
                             Object initialSelectionValue)
```
    This method shows an internal input dialog with the given message, title message type, icon, selection value list and initial selection value. The internal frame dialog will be placed in the first JDesktopPane ancestor found in the given parent component. This method returns the input value from the user.
    
    Parameters:
    parentComponent - The parent to find a JDesktopPane in.
    message - The message to display.
    title - The title to display.
    messageType - The message type.
    icon - The icon to display.
    selectionValues - The selection value list.
    initialSelectionValue - The initial selection value.
    
    Returns:
    The user input value.
  - showInternalMessageDialog
```
public static void showInternalMessageDialog(Component parentComponent,
                             Object message)
```
    This method shows an internal message dialog with the given message. The internal frame dialog will be placed in the first JDesktopPane ancestor found in the given parent component.
    
    Parameters:
    parentComponent - The component to find a JDesktopPane in.
    message - The message to display.
  - showInternalMessageDialog
```
public static void showInternalMessageDialog(Component parentComponent,
                             Object message,
                             String title,
                             int messageType)
```
    This method shows an internal message dialog with the given message, title and message type. The internal message dialog is placed in the first JDesktopPane ancestor found in the given parent component.
    
    Parameters:
    parentComponent - The parent component to find a JDesktopPane in.
    message - The message to display.
    title - The title to display.
    messageType - The message type.
  - showInternalMessageDialog
```
public static void showInternalMessageDialog(Component parentComponent,
                             Object message,
                             String title,
                             int messageType,
                             Icon icon)
```
    This method shows an internal message dialog with the given message, title, message type and icon. The internal message dialog is placed in the first JDesktopPane ancestor found in the given parent component.
    
    Parameters:
    parentComponent - The component to find a JDesktopPane in.
    message - The message to display.
    title - The title to display.
    messageType - The message type.
    icon - The icon to display.
  - showInternalOptionDialog
```
public static int showInternalOptionDialog(Component parentComponent,
                           Object message,
                           String title,
                           int optionType,
                           int messageType,
                           Icon icon,
                           Object[] options,
                           Object initialValue)
```
    This method displays an internal option dialog with the given message, title, option type, message type, icon, option list, and initial option value. The internal option dialog is placed in the first JDesktopPane ancestor found in the parent component. This method returns the option selected.
    
    Parameters:
    parentComponent - The parent to find a JDesktopPane in.
    message - The message displayed.
    title - The title displayed.
    optionType - The option type.
    messageType - The message type.
    icon - The icon to display.
    options - The array of options.
    initialValue - The initial value selected.
    
    Returns:
    The option that was selected.
  - showMessageDialog
```
public static void showMessageDialog(Component parentComponent,
                     Object message)
```
    This method shows an INFORMATION_MESSAGE type message dialog.
    
    Parameters:
    parentComponent - The component to find a frame in.
    message - The message displayed.
  - showMessageDialog
```
public static void showMessageDialog(Component parentComponent,
                     Object message,
                     String title,
                     int messageType)
```
    This method shows a message dialog with the given message, title and messageType.
    
    Parameters:
    parentComponent - The component to find a frame in.
    message - The message displayed.
    title - The title of the dialog.
    messageType - The messageType.
  - showMessageDialog
```
public static void showMessageDialog(Component parentComponent,
                     Object message,
                     String title,
                     int messageType,
                     Icon icon)
```
    This method shows a message dialog with the given message, title, messageType and icon.
    
    Parameters:
    parentComponent - The component to find a frame in.
    message - The message displayed.
    title - The title of the dialog.
    messageType - The messageType.
    icon - The icon displayed.
  - showOptionDialog
```
public static int showOptionDialog(Component parentComponent,
                   Object message,
                   String title,
                   int optionType,
                   int messageType,
                   Icon icon,
                   Object[] options,
                   Object initialValue)
```
    This method shows an option dialog with the given message, title, optionType, messageType, icon, options and initialValue. This method returns the option that was selected.
    
    Parameters:
    parentComponent - The component to find a frame in.
    message - The message displayed.
    title - The title of the dialog.
    optionType - The optionType.
    messageType - The messageType.
    icon - The icon displayed.
    options - The options to choose from.
    initialValue - The initial value.
    
    Returns:
    The selected option.
  - updateUI
```
public void updateUI()
```
    This method resets the UI to the Look and Feel default.
    
    Overrides:
    
    updateUI in class JComponent

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

Constructor Summary

Method Summary

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

Field Detail

CANCEL_OPTION

CLOSED_OPTION

DEFAULT_OPTION

NO_OPTION

OK_CANCEL_OPTION

OK_OPTION

YES_NO_CANCEL_OPTION

YES_NO_OPTION

YES_OPTION

ERROR_MESSAGE

INFORMATION_MESSAGE

PLAIN_MESSAGE

QUESTION_MESSAGE

WARNING_MESSAGE

ICON_PROPERTY

INITIAL_SELECTION_VALUE_PROPERTY

INITIAL_VALUE_PROPERTY

INPUT_VALUE_PROPERTY

MESSAGE_PROPERTY

MESSAGE_TYPE_PROPERTY

OPTION_TYPE_PROPERTY

OPTIONS_PROPERTY

SELECTION_VALUES_PROPERTY

VALUE_PROPERTY

WANTS_INPUT_PROPERTY

UNINITIALIZED_VALUE

icon

initialSelectionValue

initialValue

inputValue

message

messageType

options

optionType

selectionValues

value

wantsInput

Constructor Detail

JOptionPane

JOptionPane

JOptionPane

JOptionPane

JOptionPane

JOptionPane

JOptionPane

Method Detail

createDialog

createInternalFrame

getAccessibleContext

getDesktopPaneForComponent

getFrameForComponent

getIcon

getInitialSelectionValue

getInitialValue

getInputValue

getMaxCharactersPerLineCount

getMessage

getMessageType

getOptions

getOptionType

getRootFrame

getSelectionValues

getUI

getUIClassID