Package com.jidesoft.dialog
Class JideOptionPane
java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JOptionPane
com.jidesoft.dialog.JideOptionPane
- All Implemented Interfaces:
ImageObserver
,MenuContainer
,Serializable
,Accessible
JideOptionPane
is an enhanced version of JOptionPane.
This component is still in beta, thus we didn't include the UIDefault needed by this component into
LookAndFeelFactory by default. If you want to use it, please refer to JideOptionPaneDemo's getDemoPanel method where
we add all necessary UIDefaults using UIDefaultCustomizer.- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class javax.swing.JOptionPane
JOptionPane.AccessibleJOptionPane
Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int
A new type for the option pane to have only the close button.static final String
Bound property name fordetails
.static final String
Bound property name fortitle
.Fields inherited from class javax.swing.JOptionPane
CANCEL_OPTION, CLOSED_OPTION, DEFAULT_OPTION, ERROR_MESSAGE, icon, ICON_PROPERTY, INFORMATION_MESSAGE, INITIAL_SELECTION_VALUE_PROPERTY, INITIAL_VALUE_PROPERTY, initialSelectionValue, initialValue, INPUT_VALUE_PROPERTY, inputValue, message, MESSAGE_PROPERTY, MESSAGE_TYPE_PROPERTY, messageType, NO_OPTION, OK_CANCEL_OPTION, OK_OPTION, OPTION_TYPE_PROPERTY, options, OPTIONS_PROPERTY, optionType, PLAIN_MESSAGE, QUESTION_MESSAGE, SELECTION_VALUES_PROPERTY, selectionValues, UNINITIALIZED_VALUE, value, VALUE_PROPERTY, WANTS_INPUT_PROPERTY, wantsInput, WARNING_MESSAGE, YES_NO_CANCEL_OPTION, YES_NO_OPTION, YES_OPTION
Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
Constructor Summary
ConstructorsConstructorDescriptionJideOptionPane
(Object message) JideOptionPane
(Object message, int messageType) JideOptionPane
(Object message, int messageType, int optionType) JideOptionPane
(Object message, int messageType, int optionType, Icon icon) JideOptionPane
(Object message, int messageType, int optionType, Icon icon, Object[] options) JideOptionPane
(Object message, int messageType, int optionType, Icon icon, Object[] options, Object initialValue) -
Method Summary
Modifier and TypeMethodDescriptioncreateDialog
(Component parentComponent, String title) Creates and returns a newJDialog
wrappingthis
centered on theparentComponent
in theparentComponent
's frame.createDialog
(String title) Creates and returns a new parentlessJDialog
with the specified title.Gets the details object.static Frame
getFrameForComponent
(Component parentComponent) Returns the specified component'sFrame
.getResourceString
(String key) Gets the localized string from resource bundle.getTitle()
Gets the title of the option pane.protected void
boolean
Checks if the details component is visible.void
setDetails
(Object details) Sets the details object.void
setDetailsVisible
(boolean visible) Sets the details component visible.void
void
setOptionType
(int newType) Overrides the method in JOptionPane to allow a new option - CLOSE_OPTION.void
Sets the title of the option pane.static int
showConfirmDialog
(Component parentComponent, Object message) Brings up a dialog with the options Yes, No and Cancel; with the title, Select an Option.static int
showConfirmDialog
(Component parentComponent, Object message, String title, int optionType) Brings up a dialog where the number of choices is determined by theoptionType
parameter.static int
showConfirmDialog
(Component parentComponent, Object message, String title, int optionType, int messageType) Brings up a dialog where the number of choices is determined by theoptionType
parameter, where themessageType
parameter determines the icon to display.static int
showConfirmDialog
(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon) Brings up a dialog with a specified icon, where the number of choices is determined by theoptionType
parameter.static String
showInputDialog
(Component parentComponent, Object message) Shows a question-message dialog requesting input from the user parented toparentComponent
.static String
showInputDialog
(Component parentComponent, Object message, Object initialSelectionValue) Shows a question-message dialog requesting input from the user and parented toparentComponent
.static String
showInputDialog
(Component parentComponent, Object message, String title, int messageType) Shows a dialog requesting input from the user parented toparentComponent
with the dialog having the titletitle
and message typemessageType
.static Object
showInputDialog
(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue) Prompts the user for input in a blocking dialog where the initial selection, possible selections, and all other options can be specified.static String
showInputDialog
(Object message) Shows a question-message dialog requesting input from the user.static String
showInputDialog
(Object message, Object initialSelectionValue) Shows a question-message dialog requesting input from the user, with the input value initialized toinitialSelectionValue
.static void
showMessageDialog
(Component parentComponent, Object message) Brings up an information-message dialog titled "Message".static void
showMessageDialog
(Component parentComponent, Object message, String title, int messageType) Brings up a dialog that displays a message using a default icon determined by themessageType
parameter.static void
showMessageDialog
(Component parentComponent, Object message, String title, int messageType, Icon icon) Brings up a dialog displaying a message, specifying all parameters.static int
showOptionDialog
(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue) Brings up a dialog with a specified icon, where the initial choice is determined by theinitialValue
parameter and the number of choices is determined by theoptionType
parameter.Methods inherited from class javax.swing.JOptionPane
createInternalFrame, getAccessibleContext, getDesktopPaneForComponent, getIcon, getInitialSelectionValue, getInitialValue, getInputValue, getMaxCharactersPerLineCount, getMessage, getMessageType, getOptions, getOptionType, getRootFrame, getSelectionValues, getUI, getUIClassID, getValue, getWantsInput, paramString, selectInitialValue, setIcon, setInitialSelectionValue, setInitialValue, setInputValue, setMessage, setMessageType, setOptions, setRootFrame, setSelectionValues, setUI, setValue, setWantsInput, showInternalConfirmDialog, showInternalConfirmDialog, showInternalConfirmDialog, showInternalConfirmDialog, showInternalInputDialog, showInternalInputDialog, showInternalInputDialog, showInternalMessageDialog, showInternalMessageDialog, showInternalMessageDialog, showInternalOptionDialog, updateUI
Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
Field Details
-
DETAILS_PROPERTY
Bound property name fordetails
.- See Also:
-
TITLE_PROPERTY
Bound property name fortitle
.- See Also:
-
CLOSE_OPTION
public static final int CLOSE_OPTIONA new type for the option pane to have only the close button.- See Also:
-
-
Constructor Details
-
JideOptionPane
public JideOptionPane() -
JideOptionPane
-
JideOptionPane
-
JideOptionPane
-
JideOptionPane
-
JideOptionPane
-
JideOptionPane
-
-
Method Details
-
initComponents
protected void initComponents() -
setOptionType
public void setOptionType(int newType) Overrides the method in JOptionPane to allow a new option - CLOSE_OPTION.- Overrides:
setOptionType
in classJOptionPane
- Parameters:
newType
- the type of the option pane.
-
setDetails
Sets the details object. The object can be a string or a component. If it is a string, it will be put into a JTextArea. If it is a component, it will be used directly. As long as the value is not null, a "Details" button will be added to button panel allowing you to show or hide the details panel.- Parameters:
details
- the details.
-
getDetails
Gets the details object. The object can be a string or a component. If it is a string, it will be put into a JTextArea. If it is a component, it will be used directly. As long as the value is not null, a "Details" button will be added to button panel allowing you to show or hide the details panel.- Returns:
- the details object.
-
getTitle
Gets the title of the option pane.- Returns:
- the title of the option pane.
-
setTitle
Sets the title of the option pane.- Parameters:
title
- the new title of the option pane.
-
setDetailsVisible
public void setDetailsVisible(boolean visible) Sets the details component visible. Please note that you need to call this method before the option pane is shown. The visible flag is actually stored on a static field so if you set one option pane visible, all option panes' details component will be visible.- Parameters:
visible
- true or false.
-
getResourceString
Gets the localized string from resource bundle. Subclass can override it to provide its own string. Available keys are defined in buttons.properties that begin with "Button.".- Parameters:
key
- the resource string key- Returns:
- the localized string.
-
isDetailsVisible
public boolean isDetailsVisible()Checks if the details component is visible.- Returns:
- true if visible. Otherwise false.
-
setLocale
-
showInputDialog
Shows a question-message dialog requesting input from the user. The dialog uses the default frame, which usually means it is centered on the screen.- Parameters:
message
- theObject
to display- Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
showInputDialog
Shows a question-message dialog requesting input from the user, with the input value initialized toinitialSelectionValue
. The dialog uses the default frame, which usually means it is centered on the screen.- Parameters:
message
- theObject
to displayinitialSelectionValue
- the value used to initialize the input field- Since:
- 1.4
-
showInputDialog
public static String showInputDialog(Component parentComponent, Object message) throws HeadlessException Shows a question-message dialog requesting input from the user parented toparentComponent
. The dialog is displayed on top of theComponent
's frame, and is usually positioned below theComponent
.- Parameters:
parentComponent
- the parentComponent
for the dialogmessage
- theObject
to display- Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
showInputDialog
public static String showInputDialog(Component parentComponent, Object message, Object initialSelectionValue) Shows a question-message dialog requesting input from the user and parented toparentComponent
. The input value will be initialized toinitialSelectionValue
. The dialog is displayed on top of theComponent
's frame, and is usually positioned below theComponent
.- Parameters:
parentComponent
- the parentComponent
for the dialogmessage
- theObject
to displayinitialSelectionValue
- the value used to initialize the input field- Since:
- 1.4
-
showInputDialog
public static String showInputDialog(Component parentComponent, Object message, String title, int messageType) throws HeadlessException Shows a dialog requesting input from the user parented toparentComponent
with the dialog having the titletitle
and message typemessageType
.- Parameters:
parentComponent
- the parentComponent
for the dialogmessage
- theObject
to displaytitle
- theString
to display in the dialog title barmessageType
- the type of message that is to be displayed:ERROR_MESSAGE
,INFORMATION_MESSAGE
,WARNING_MESSAGE
,QUESTION_MESSAGE
, orPLAIN_MESSAGE
- Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
showInputDialog
public static Object showInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue) throws HeadlessException Prompts the user for input in a blocking dialog where the initial selection, possible selections, and all other options can be specified. The user will able to choose fromselectionValues
, wherenull
implies the user can input whatever they wish, usually by means of aJTextField
.initialSelectionValue
is the initial value to prompt the user with. It is up to the UI to decide how best to represent theselectionValues
, but usually aJComboBox
,JList
, orJTextField
will be used.- Parameters:
parentComponent
- the parentComponent
for the dialogmessage
- theObject
to displaytitle
- theString
to display in the dialog title barmessageType
- the type of message to be displayed:ERROR_MESSAGE
,INFORMATION_MESSAGE
,WARNING_MESSAGE
,QUESTION_MESSAGE
, orPLAIN_MESSAGE
icon
- theIcon
image to displayselectionValues
- an array ofObject
s that gives the possible selectionsinitialSelectionValue
- the value used to initialize the input field- Returns:
- user's input, or
null
meaning the user canceled the input - Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
showMessageDialog
public static void showMessageDialog(Component parentComponent, Object message) throws HeadlessException Brings up an information-message dialog titled "Message".- Parameters:
parentComponent
- determines theFrame
in which the dialog is displayed; ifnull
, or if theparentComponent
has noFrame
, a defaultFrame
is usedmessage
- theObject
to display- Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
showMessageDialog
public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType) throws HeadlessException Brings up a dialog that displays a message using a default icon determined by themessageType
parameter.- Parameters:
parentComponent
- determines theFrame
in which the dialog is displayed; ifnull
, or if theparentComponent
has noFrame
, a defaultFrame
is usedmessage
- theObject
to displaytitle
- the title string for the dialogmessageType
- the type of message to be displayed:ERROR_MESSAGE
,INFORMATION_MESSAGE
,WARNING_MESSAGE
,QUESTION_MESSAGE
, orPLAIN_MESSAGE
- Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
showMessageDialog
public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon) throws HeadlessException Brings up a dialog displaying a message, specifying all parameters.- Parameters:
parentComponent
- determines theFrame
in which the dialog is displayed; ifnull
, or if theparentComponent
has noFrame
, a defaultFrame
is usedmessage
- theObject
to displaytitle
- the title string for the dialogmessageType
- the type of message to be displayed:ERROR_MESSAGE
,INFORMATION_MESSAGE
,WARNING_MESSAGE
,QUESTION_MESSAGE
, orPLAIN_MESSAGE
icon
- an icon to display in the dialog that helps the user identify the kind of message that is being displayed- Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
showConfirmDialog
public static int showConfirmDialog(Component parentComponent, Object message) throws HeadlessException Brings up a dialog with the options Yes, No and Cancel; with the title, Select an Option.- Parameters:
parentComponent
- determines theFrame
in which the dialog is displayed; ifnull
, or if theparentComponent
has noFrame
, a defaultFrame
is usedmessage
- theObject
to display- Returns:
- an integer indicating the option selected by the user
- Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
showConfirmDialog
public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType) throws HeadlessException Brings up a dialog where the number of choices is determined by theoptionType
parameter.- Parameters:
parentComponent
- determines theFrame
in which the dialog is displayed; ifnull
, or if theparentComponent
has noFrame
, a defaultFrame
is usedmessage
- theObject
to displaytitle
- the title string for the dialogoptionType
- an int designating the options available on the dialog:YES_NO_OPTION
,YES_NO_CANCEL_OPTION
, orOK_CANCEL_OPTION
- Returns:
- an int indicating the option selected by the user
- Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
showConfirmDialog
public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType) throws HeadlessException Brings up a dialog where the number of choices is determined by theoptionType
parameter, where themessageType
parameter determines the icon to display. ThemessageType
parameter is primarily used to supply a default icon from the Look and Feel.- Parameters:
parentComponent
- determines theFrame
in which the dialog is displayed; ifnull
, or if theparentComponent
has noFrame
, a defaultFrame
is used.message
- theObject
to displaytitle
- the title string for the dialogoptionType
- an integer designating the options available on the dialog:YES_NO_OPTION
,YES_NO_CANCEL_OPTION
, orOK_CANCEL_OPTION
messageType
- an integer designating the kind of message this is; primarily used to determine the icon from the pluggable Look and Feel:ERROR_MESSAGE
,INFORMATION_MESSAGE
,WARNING_MESSAGE
,QUESTION_MESSAGE
, orPLAIN_MESSAGE
- Returns:
- an integer indicating the option selected by the user
- Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
showConfirmDialog
public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon) throws HeadlessException Brings up a dialog with a specified icon, where the number of choices is determined by theoptionType
parameter. ThemessageType
parameter is primarily used to supply a default icon from the look and feel.- Parameters:
parentComponent
- determines theFrame
in which the dialog is displayed; ifnull
, or if theparentComponent
has noFrame
, a defaultFrame
is usedmessage
- the Object to displaytitle
- the title string for the dialogoptionType
- an int designating the options available on the dialog:YES_NO_OPTION
,YES_NO_CANCEL_OPTION
, orOK_CANCEL_OPTION
messageType
- an int designating the kind of message this is, primarily used to determine the icon from the pluggable Look and Feel:ERROR_MESSAGE
,INFORMATION_MESSAGE
,WARNING_MESSAGE
,QUESTION_MESSAGE
, orPLAIN_MESSAGE
icon
- the icon to display in the dialog- Returns:
- an int indicating the option selected by the user
- Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
showOptionDialog
public static int showOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue) throws HeadlessException Brings up a dialog with a specified icon, where the initial choice is determined by theinitialValue
parameter and the number of choices is determined by theoptionType
parameter. IfoptionType
isYES_NO_OPTION
, orYES_NO_CANCEL_OPTION
and theoptions
parameter isnull
, then the options are supplied by the look and feel. ThemessageType
parameter is primarily used to supply a default icon from the look and feel.- Parameters:
parentComponent
- determines theFrame
in which the dialog is displayed; ifnull
, or if theparentComponent
has noFrame
, a defaultFrame
is usedmessage
- theObject
to displaytitle
- the title string for the dialogoptionType
- an integer designating the options available on the dialog:DEFAULT_OPTION
,YES_NO_OPTION
,YES_NO_CANCEL_OPTION
, orOK_CANCEL_OPTION
messageType
- an integer designating the kind of message this is, primarily used to determine the icon from the pluggable Look and Feel:ERROR_MESSAGE
,INFORMATION_MESSAGE
,WARNING_MESSAGE
,QUESTION_MESSAGE
, orPLAIN_MESSAGE
icon
- the icon to display in the dialogoptions
- an array of objects indicating the possible choices the user can make; if the objects are components, they are rendered properly; non-String
objects are rendered using theirtoString
methods; if this parameter isnull
, the options are determined by the Look and FeelinitialValue
- the object that represents the default selection for the dialog; only meaningful ifoptions
is used; can benull
- Returns:
- an integer indicating the option chosen by the user, or
CLOSED_OPTION
if the user closed the dialog - Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
createDialog
Creates and returns a newJDialog
wrappingthis
centered on theparentComponent
in theparentComponent
's frame.title
is the title of the returned dialog. The returnedJDialog
will not be resizable by the user, however programs can invokesetResizable
on theJDialog
instance to change this property. The returnedJDialog
will be set up such that once it is closed, or the user clicks on one of the buttons, the optionpane's value property will be set accordingly and the dialog will be closed. Each time the dialog is made visible, it will reset the option pane's value property toJOptionPane.UNINITIALIZED_VALUE
to ensure the user's subsequent action closes the dialog properly.- Overrides:
createDialog
in classJOptionPane
- Parameters:
parentComponent
- determines the frame in which the dialog is displayed; if theparentComponent
has noFrame
, a defaultFrame
is usedtitle
- the title string for the dialog- Returns:
- a new
JDialog
containing this instance - Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-
createDialog
Creates and returns a new parentlessJDialog
with the specified title. The returnedJDialog
will not be resizable by the user, however programs can invokesetResizable
on theJDialog
instance to change this property. The returnedJDialog
will be set up such that once it is closed, or the user clicks on one of the buttons, the optionpane's value property will be set accordingly and the dialog will be closed. Each time the dialog is made visible, it will reset the option pane's value property toJOptionPane.UNINITIALIZED_VALUE
to ensure the user's subsequent action closes the dialog properly.- Overrides:
createDialog
in classJOptionPane
- Parameters:
title
- the title string for the dialog- Returns:
- a new
JDialog
containing this instance - Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- Since:
- 1.6
- See Also:
-
getFrameForComponent
Returns the specified component'sFrame
.- Parameters:
parentComponent
- theComponent
to check for aFrame
- Returns:
- the
Frame
that contains the component, orgetRootFrame
if the component isnull
, or does not have a validFrame
parent - Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless
returnstrue
- See Also:
-