< prev index next >

src/java.desktop/share/classes/javax/swing/JOptionPane.java

Print this page

        

*** 54,76 **** import javax.accessibility.*; import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP; import sun.awt.AWTAccessor; /** ! * <code>JOptionPane</code> makes it easy to pop up a standard dialog box that * prompts users for a value or informs them of something. ! * For information about using <code>JOptionPane</code>, see * <a href="http://docs.oracle.com/javase/tutorial/uiswing/components/dialog.html">How to Make Dialogs</a>, * a section in <em>The Java Tutorial</em>. * * <p> * ! * While the <code>JOptionPane</code> * class may appear complex because of the large number of methods, almost * all uses of this class are one-line calls to one of the static ! * <code>showXxxDialog</code> methods shown below: * <blockquote> * * * <table border=1 summary="Common JOptionPane method names and their descriptions"> * <tr> --- 54,76 ---- import javax.accessibility.*; import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP; import sun.awt.AWTAccessor; /** ! * {@code JOptionPane} makes it easy to pop up a standard dialog box that * prompts users for a value or informs them of something. ! * For information about using {@code JOptionPane}, see * <a href="http://docs.oracle.com/javase/tutorial/uiswing/components/dialog.html">How to Make Dialogs</a>, * a section in <em>The Java Tutorial</em>. * * <p> * ! * While the {@code JOptionPane} * class may appear complex because of the large number of methods, almost * all uses of this class are one-line calls to one of the static ! * {@code showXxxDialog} methods shown below: * <blockquote> * * * <table border=1 summary="Common JOptionPane method names and their descriptions"> * <tr>
*** 94,110 **** * <td>The Grand Unification of the above three.</td> * </tr> * </table> * * </blockquote> ! * Each of these methods also comes in a <code>showInternalXXX</code> * flavor, which uses an internal frame to hold the dialog box (see * {@link JInternalFrame}). * Multiple convenience methods have also been defined -- overloaded * versions of the basic methods that use different parameter lists. * <p> ! * All dialogs are modal. Each <code>showXxxDialog</code> method blocks * the caller until the user's interaction is complete. * * <table cellspacing=6 cellpadding=4 border=0 style="float:right" summary="layout"> * <tr> * <td style="background-color:#FFe0d0" rowspan=2>icon</td> --- 94,110 ---- * <td>The Grand Unification of the above three.</td> * </tr> * </table> * * </blockquote> ! * Each of these methods also comes in a {@code showInternalXXX} * flavor, which uses an internal frame to hold the dialog box (see * {@link JInternalFrame}). * Multiple convenience methods have also been defined -- overloaded * versions of the basic methods that use different parameter lists. * <p> ! * All dialogs are modal. Each {@code showXxxDialog} method blocks * the caller until the user's interaction is complete. * * <table cellspacing=6 cellpadding=4 border=0 style="float:right" summary="layout"> * <tr> * <td style="background-color:#FFe0d0" rowspan=2>icon</td>
*** 121,230 **** * The basic appearance of one of these dialog boxes is generally * similar to the picture at the right, although the various * look-and-feels are * ultimately responsible for the final result. In particular, the * look-and-feels will adjust the layout to accommodate the option pane's ! * <code>ComponentOrientation</code> property. * <br style="clear:all"> * <p> * <b>Parameters:</b><br> * The parameters to these methods follow consistent patterns: * <blockquote> * <dl> * <dt>parentComponent<dd> ! * Defines the <code>Component</code> that is to be the parent of this * dialog box. ! * It is used in two ways: the <code>Frame</code> that contains ! * it is used as the <code>Frame</code> * parent for the dialog box, and its screen coordinates are used in * the placement of the dialog box. In general, the dialog box is placed ! * just below the component. This parameter may be <code>null</code>, ! * in which case a default <code>Frame</code> is used as the parent, * and the dialog will be * centered on the screen (depending on the {@literal L&F}). * <dt><a name=message>message</a><dd> * A descriptive message to be placed in the dialog box. ! * In the most common usage, message is just a <code>String</code> or ! * <code>String</code> constant. ! * However, the type of this parameter is actually <code>Object</code>. Its * interpretation depends on its type: * <dl> * <dt>Object[]<dd>An array of objects is interpreted as a series of * messages (one per object) arranged in a vertical stack. * The interpretation is recursive -- each object in the * array is interpreted according to its type. ! * <dt>Component<dd>The <code>Component</code> is displayed in the dialog. ! * <dt>Icon<dd>The <code>Icon</code> is wrapped in a <code>JLabel</code> * and displayed in the dialog. ! * <dt>others<dd>The object is converted to a <code>String</code> by calling ! * its <code>toString</code> method. The result is wrapped in a ! * <code>JLabel</code> and displayed. * </dl> * <dt>messageType<dd>Defines the style of the message. The Look and Feel * manager may lay out the dialog differently depending on this value, and * will often provide a default icon. The possible values are: * <ul> ! * <li><code>ERROR_MESSAGE</code> ! * <li><code>INFORMATION_MESSAGE</code> ! * <li><code>WARNING_MESSAGE</code> ! * <li><code>QUESTION_MESSAGE</code> ! * <li><code>PLAIN_MESSAGE</code> * </ul> * <dt>optionType<dd>Defines the set of option buttons that appear at * the bottom of the dialog box: * <ul> ! * <li><code>DEFAULT_OPTION</code> ! * <li><code>YES_NO_OPTION</code> ! * <li><code>YES_NO_CANCEL_OPTION</code> ! * <li><code>OK_CANCEL_OPTION</code> * </ul> * You aren't limited to this set of option buttons. You can provide any * buttons you want using the options parameter. * <dt>options<dd>A more detailed description of the set of option buttons * that will appear at the bottom of the dialog box. * The usual value for the options parameter is an array of ! * <code>String</code>s. But ! * the parameter type is an array of <code>Objects</code>. * A button is created for each object depending on its type: * <dl> * <dt>Component<dd>The component is added to the button row directly. ! * <dt>Icon<dd>A <code>JButton</code> is created with this as its label. ! * <dt>other<dd>The <code>Object</code> is converted to a string using its ! * <code>toString</code> method and the result is used to ! * label a <code>JButton</code>. * </dl> * <dt>icon<dd>A decorative icon to be placed in the dialog box. A default ! * value for this is determined by the <code>messageType</code> parameter. * <dt>title<dd>The title for the dialog box. * <dt>initialValue<dd>The default selection (input value). * </dl> * </blockquote> * <p> ! * When the selection is changed, <code>setValue</code> is invoked, ! * which generates a <code>PropertyChangeEvent</code>. * <p> ! * If a <code>JOptionPane</code> has configured to all input ! * <code>setWantsInput</code> ! * the bound property <code>JOptionPane.INPUT_VALUE_PROPERTY</code> * can also be listened * to, to determine when the user has input or selected a value. * <p> ! * When one of the <code>showXxxDialog</code> methods returns an integer, * the possible values are: * <ul> ! * <li><code>YES_OPTION</code> ! * <li><code>NO_OPTION</code> ! * <li><code>CANCEL_OPTION</code> ! * <li><code>OK_OPTION</code> ! * <li><code>CLOSED_OPTION</code> * </ul> * <b>Examples:</b> * <dl> * <dt>Show an error dialog that displays the message, 'alert': ! * <dd><code> * JOptionPane.showMessageDialog(null, "alert", "alert", JOptionPane.ERROR_MESSAGE); ! * </code> * <dt>Show an internal information dialog with the message, 'information': * <dd><pre> * JOptionPane.showInternalMessageDialog(frame, "information", * "information", JOptionPane.INFORMATION_MESSAGE); * </pre> --- 121,230 ---- * The basic appearance of one of these dialog boxes is generally * similar to the picture at the right, although the various * look-and-feels are * ultimately responsible for the final result. In particular, the * look-and-feels will adjust the layout to accommodate the option pane's ! * {@code ComponentOrientation} property. * <br style="clear:all"> * <p> * <b>Parameters:</b><br> * The parameters to these methods follow consistent patterns: * <blockquote> * <dl> * <dt>parentComponent<dd> ! * Defines the {@code Component} that is to be the parent of this * dialog box. ! * It is used in two ways: the {@code Frame} that contains ! * it is used as the {@code Frame} * parent for the dialog box, and its screen coordinates are used in * the placement of the dialog box. In general, the dialog box is placed ! * just below the component. This parameter may be {@code null}, ! * in which case a default {@code Frame} is used as the parent, * and the dialog will be * centered on the screen (depending on the {@literal L&F}). * <dt><a name=message>message</a><dd> * A descriptive message to be placed in the dialog box. ! * In the most common usage, message is just a {@code String} or ! * {@code String} constant. ! * However, the type of this parameter is actually {@code Object}. Its * interpretation depends on its type: * <dl> * <dt>Object[]<dd>An array of objects is interpreted as a series of * messages (one per object) arranged in a vertical stack. * The interpretation is recursive -- each object in the * array is interpreted according to its type. ! * <dt>Component<dd>The {@code Component} is displayed in the dialog. ! * <dt>Icon<dd>The {@code Icon} is wrapped in a {@code JLabel} * and displayed in the dialog. ! * <dt>others<dd>The object is converted to a {@code String} by calling ! * its {@code toString} method. The result is wrapped in a ! * {@code JLabel} and displayed. * </dl> * <dt>messageType<dd>Defines the style of the message. The Look and Feel * manager may lay out the dialog differently depending on this value, and * will often provide a default icon. The possible values are: * <ul> ! * <li>{@code ERROR_MESSAGE} ! * <li>{@code INFORMATION_MESSAGE} ! * <li>{@code WARNING_MESSAGE} ! * <li>{@code QUESTION_MESSAGE} ! * <li>{@code PLAIN_MESSAGE} * </ul> * <dt>optionType<dd>Defines the set of option buttons that appear at * the bottom of the dialog box: * <ul> ! * <li>{@code DEFAULT_OPTION} ! * <li>{@code YES_NO_OPTION} ! * <li>{@code YES_NO_CANCEL_OPTION} ! * <li>{@code OK_CANCEL_OPTION} * </ul> * You aren't limited to this set of option buttons. You can provide any * buttons you want using the options parameter. * <dt>options<dd>A more detailed description of the set of option buttons * that will appear at the bottom of the dialog box. * The usual value for the options parameter is an array of ! * {@code String}s. But ! * the parameter type is an array of {@code Objects}. * A button is created for each object depending on its type: * <dl> * <dt>Component<dd>The component is added to the button row directly. ! * <dt>Icon<dd>A {@code JButton} is created with this as its label. ! * <dt>other<dd>The {@code Object} is converted to a string using its ! * {@code toString} method and the result is used to ! * label a {@code JButton}. * </dl> * <dt>icon<dd>A decorative icon to be placed in the dialog box. A default ! * value for this is determined by the {@code messageType} parameter. * <dt>title<dd>The title for the dialog box. * <dt>initialValue<dd>The default selection (input value). * </dl> * </blockquote> * <p> ! * When the selection is changed, {@code setValue} is invoked, ! * which generates a {@code PropertyChangeEvent}. * <p> ! * If a {@code JOptionPane} has configured to all input ! * {@code setWantsInput} ! * the bound property {@code JOptionPane.INPUT_VALUE_PROPERTY} * can also be listened * to, to determine when the user has input or selected a value. * <p> ! * When one of the {@code showXxxDialog} methods returns an integer, * the possible values are: * <ul> ! * <li>{@code YES_OPTION} ! * <li>{@code NO_OPTION} ! * <li>{@code CANCEL_OPTION} ! * <li>{@code OK_OPTION} ! * <li>{@code CLOSED_OPTION} * </ul> * <b>Examples:</b> * <dl> * <dt>Show an error dialog that displays the message, 'alert': ! * <dd>{@code * JOptionPane.showMessageDialog(null, "alert", "alert", JOptionPane.ERROR_MESSAGE); ! * } * <dt>Show an internal information dialog with the message, 'information': * <dd><pre> * JOptionPane.showInternalMessageDialog(frame, "information", * "information", JOptionPane.INFORMATION_MESSAGE); * </pre>
*** 245,268 **** * JOptionPane.showOptionDialog(null, "Click OK to continue", "Warning", * JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE, * null, options, options[0]); * </pre> * <dt>Show a dialog asking the user to type in a String: ! * <dd><code> * String inputValue = JOptionPane.showInputDialog("Please input a value"); ! * </code> * <dt>Show a dialog asking the user to select a String: * <dd><pre> * Object[] possibleValues = { "First", "Second", "Third" };<br> * Object selectedValue = JOptionPane.showInputDialog(null, * "Choose one", "Input", * JOptionPane.INFORMATION_MESSAGE, null, * possibleValues, possibleValues[0]); * </pre> * </dl> * <b>Direct Use:</b><br> ! * To create and use an <code>JOptionPane</code> directly, the * standard pattern is roughly as follows: * <pre> * JOptionPane pane = new JOptionPane(<i>arguments</i>); * pane.set<i>.Xxxx(...); // Configure</i> * JDialog dialog = pane.createDialog(<i>parentComponent, title</i>); --- 245,268 ---- * JOptionPane.showOptionDialog(null, "Click OK to continue", "Warning", * JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE, * null, options, options[0]); * </pre> * <dt>Show a dialog asking the user to type in a String: ! * <dd>{@code * String inputValue = JOptionPane.showInputDialog("Please input a value"); ! * } * <dt>Show a dialog asking the user to select a String: * <dd><pre> * Object[] possibleValues = { "First", "Second", "Third" };<br> * Object selectedValue = JOptionPane.showInputDialog(null, * "Choose one", "Input", * JOptionPane.INFORMATION_MESSAGE, null, * possibleValues, possibleValues[0]); * </pre> * </dl> * <b>Direct Use:</b><br> ! * To create and use an {@code JOptionPane} directly, the * standard pattern is roughly as follows: * <pre> * JOptionPane pane = new JOptionPane(<i>arguments</i>); * pane.set<i>.Xxxx(...); // Configure</i> * JDialog dialog = pane.createDialog(<i>parentComponent, title</i>);
*** 294,304 **** * Serialized objects of this class will not be compatible with * future Swing releases. The current serialization support is * appropriate for short term storage or RMI between applications running * the same version of Swing. As of 1.4, support for long term storage * of all JavaBeans&trade; ! * has been added to the <code>java.beans</code> package. * Please see {@link java.beans.XMLEncoder}. * * @see JInternalFrame * * @beaninfo --- 294,304 ---- * Serialized objects of this class will not be compatible with * future Swing releases. The current serialization support is * appropriate for short term storage or RMI between applications running * the same version of Swing. As of 1.4, support for long term storage * of all JavaBeans&trade; ! * has been added to the {@code java.beans} package. * Please see {@link java.beans.XMLEncoder}. * * @see JInternalFrame * * @beaninfo
*** 327,344 **** // Option types // /** * Type meaning Look and Feel should not supply any options -- only ! * use the options from the <code>JOptionPane</code>. */ public static final int DEFAULT_OPTION = -1; ! /** Type used for <code>showConfirmDialog</code>. */ public static final int YES_NO_OPTION = 0; ! /** Type used for <code>showConfirmDialog</code>. */ public static final int YES_NO_CANCEL_OPTION = 1; ! /** Type used for <code>showConfirmDialog</code>. */ public static final int OK_CANCEL_OPTION = 2; // // Return values. // --- 327,344 ---- // Option types // /** * Type meaning Look and Feel should not supply any options -- only ! * use the options from the {@code JOptionPane}. */ public static final int DEFAULT_OPTION = -1; ! /** Type used for {@code showConfirmDialog}. */ public static final int YES_NO_OPTION = 0; ! /** Type used for {@code showConfirmDialog}. */ public static final int YES_NO_CANCEL_OPTION = 1; ! /** Type used for {@code showConfirmDialog}. */ public static final int OK_CANCEL_OPTION = 2; // // Return values. //
*** 350,360 **** public static final int CANCEL_OPTION = 2; /** Return value form class method if OK is chosen. */ public static final int OK_OPTION = 0; /** Return value from class method if user closes window without selecting * anything, more than likely this should be treated as either a ! * <code>CANCEL_OPTION</code> or <code>NO_OPTION</code>. */ public static final int CLOSED_OPTION = -1; // // Message types. Used by the UI to determine what icon to display, // and possibly what behavior to give based on the type. --- 350,360 ---- public static final int CANCEL_OPTION = 2; /** Return value form class method if OK is chosen. */ public static final int OK_OPTION = 0; /** Return value from class method if user closes window without selecting * anything, more than likely this should be treated as either a ! * {@code CANCEL_OPTION} or {@code NO_OPTION}. */ public static final int CLOSED_OPTION = -1; // // Message types. Used by the UI to determine what icon to display, // and possibly what behavior to give based on the type.
*** 368,455 **** /** Used for questions. */ public static final int QUESTION_MESSAGE = 3; /** No icon is used. */ public static final int PLAIN_MESSAGE = -1; ! /** Bound property name for <code>icon</code>. */ public static final String ICON_PROPERTY = "icon"; ! /** Bound property name for <code>message</code>. */ public static final String MESSAGE_PROPERTY = "message"; ! /** Bound property name for <code>value</code>. */ public static final String VALUE_PROPERTY = "value"; ! /** Bound property name for <code>option</code>. */ public static final String OPTIONS_PROPERTY = "options"; ! /** Bound property name for <code>initialValue</code>. */ public static final String INITIAL_VALUE_PROPERTY = "initialValue"; ! /** Bound property name for <code>type</code>. */ public static final String MESSAGE_TYPE_PROPERTY = "messageType"; ! /** Bound property name for <code>optionType</code>. */ public static final String OPTION_TYPE_PROPERTY = "optionType"; ! /** Bound property name for <code>selectionValues</code>. */ public static final String SELECTION_VALUES_PROPERTY = "selectionValues"; ! /** Bound property name for <code>initialSelectionValue</code>. */ public static final String INITIAL_SELECTION_VALUE_PROPERTY = "initialSelectionValue"; ! /** Bound property name for <code>inputValue</code>. */ public static final String INPUT_VALUE_PROPERTY = "inputValue"; ! /** Bound property name for <code>wantsInput</code>. */ public static final String WANTS_INPUT_PROPERTY = "wantsInput"; /** Icon used in pane. */ protected transient Icon icon; /** Message to display. */ protected transient Object message; /** Options to display to the user. */ protected transient Object[] options; ! /** Value that should be initially selected in <code>options</code>. */ protected transient Object initialValue; /** Message type. */ protected int messageType; /** ! * Option type, one of <code>DEFAULT_OPTION</code>, ! * <code>YES_NO_OPTION</code>, ! * <code>YES_NO_CANCEL_OPTION</code> or ! * <code>OK_CANCEL_OPTION</code>. */ protected int optionType; /** Currently selected value, will be a valid option, or ! * <code>UNINITIALIZED_VALUE</code> or <code>null</code>. */ protected transient Object value; /** Array of values the user can choose from. Look and feel will * provide the UI component to choose this from. */ protected transient Object[] selectionValues; /** Value the user has input. */ protected transient Object inputValue; ! /** Initial value to select in <code>selectionValues</code>. */ protected transient Object initialSelectionValue; /** If true, a UI widget will be provided to the user to get input. */ protected boolean wantsInput; /** * 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. * ! * @param message the <code>Object</code> to display * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @return user's input * @see java.awt.GraphicsEnvironment#isHeadless */ public static String showInputDialog(Object message) throws HeadlessException { return showInputDialog(null, message); } /** * Shows a question-message dialog requesting input from the user, with ! * the input value initialized to <code>initialSelectionValue</code>. The * dialog uses the default frame, which usually means it is centered on * the screen. * ! * @param message the <code>Object</code> to display * @param initialSelectionValue the value used to initialize the input * field * @return user's input * @since 1.4 */ --- 368,455 ---- /** Used for questions. */ public static final int QUESTION_MESSAGE = 3; /** No icon is used. */ public static final int PLAIN_MESSAGE = -1; ! /** Bound property name for {@code icon}. */ public static final String ICON_PROPERTY = "icon"; ! /** Bound property name for {@code message}. */ public static final String MESSAGE_PROPERTY = "message"; ! /** Bound property name for {@code value}. */ public static final String VALUE_PROPERTY = "value"; ! /** Bound property name for {@code option}. */ public static final String OPTIONS_PROPERTY = "options"; ! /** Bound property name for {@code initialValue}. */ public static final String INITIAL_VALUE_PROPERTY = "initialValue"; ! /** Bound property name for {@code type}. */ public static final String MESSAGE_TYPE_PROPERTY = "messageType"; ! /** Bound property name for {@code optionType}. */ public static final String OPTION_TYPE_PROPERTY = "optionType"; ! /** Bound property name for {@code selectionValues}. */ public static final String SELECTION_VALUES_PROPERTY = "selectionValues"; ! /** Bound property name for {@code initialSelectionValue}. */ public static final String INITIAL_SELECTION_VALUE_PROPERTY = "initialSelectionValue"; ! /** Bound property name for {@code inputValue}. */ public static final String INPUT_VALUE_PROPERTY = "inputValue"; ! /** Bound property name for {@code wantsInput}. */ public static final String WANTS_INPUT_PROPERTY = "wantsInput"; /** Icon used in pane. */ protected transient Icon icon; /** Message to display. */ protected transient Object message; /** Options to display to the user. */ protected transient Object[] options; ! /** Value that should be initially selected in {@code options}. */ protected transient Object initialValue; /** Message type. */ protected int messageType; /** ! * Option type, one of {@code DEFAULT_OPTION}, ! * {@code YES_NO_OPTION}, ! * {@code YES_NO_CANCEL_OPTION} or ! * {@code OK_CANCEL_OPTION}. */ protected int optionType; /** Currently selected value, will be a valid option, or ! * {@code UNINITIALIZED_VALUE} or {@code null}. */ protected transient Object value; /** Array of values the user can choose from. Look and feel will * provide the UI component to choose this from. */ protected transient Object[] selectionValues; /** Value the user has input. */ protected transient Object inputValue; ! /** Initial value to select in {@code selectionValues}. */ protected transient Object initialSelectionValue; /** If true, a UI widget will be provided to the user to get input. */ protected boolean wantsInput; /** * 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. * ! * @param message the {@code Object} to display * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @return user's input * @see java.awt.GraphicsEnvironment#isHeadless */ public static String showInputDialog(Object message) throws HeadlessException { return showInputDialog(null, message); } /** * Shows a question-message dialog requesting input from the user, with ! * the input value initialized to {@code initialSelectionValue}. The * dialog uses the default frame, which usually means it is centered on * the screen. * ! * @param message the {@code Object} to display * @param initialSelectionValue the value used to initialize the input * field * @return user's input * @since 1.4 */
*** 457,476 **** return showInputDialog(null, message, initialSelectionValue); } /** * Shows a question-message dialog requesting input from the user ! * parented to <code>parentComponent</code>. ! * The dialog is displayed on top of the <code>Component</code>'s ! * frame, and is usually positioned below the <code>Component</code>. * ! * @param parentComponent the parent <code>Component</code> for the * dialog ! * @param message the <code>Object</code> to display * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @return user's input * @see java.awt.GraphicsEnvironment#isHeadless */ public static String showInputDialog(Component parentComponent, Object message) throws HeadlessException { --- 457,476 ---- return showInputDialog(null, message, initialSelectionValue); } /** * Shows a question-message dialog requesting input from the user ! * parented to {@code parentComponent}. ! * The dialog is displayed on top of the {@code Component}'s ! * frame, and is usually positioned below the {@code Component}. * ! * @param parentComponent the parent {@code Component} for the * dialog ! * @param message the {@code Object} to display * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @return user's input * @see java.awt.GraphicsEnvironment#isHeadless */ public static String showInputDialog(Component parentComponent, Object message) throws HeadlessException {
*** 478,495 **** "OptionPane.inputDialogTitle", parentComponent), QUESTION_MESSAGE); } /** * Shows a question-message dialog requesting input from the user and ! * parented to <code>parentComponent</code>. The input value will be ! * initialized to <code>initialSelectionValue</code>. ! * The dialog is displayed on top of the <code>Component</code>'s ! * frame, and is usually positioned below the <code>Component</code>. * ! * @param parentComponent the parent <code>Component</code> for the * dialog ! * @param message the <code>Object</code> to display * @param initialSelectionValue the value used to initialize the input * field * @return user's input * @since 1.4 */ --- 478,495 ---- "OptionPane.inputDialogTitle", parentComponent), QUESTION_MESSAGE); } /** * Shows a question-message dialog requesting input from the user and ! * parented to {@code parentComponent}. The input value will be ! * initialized to {@code initialSelectionValue}. ! * The dialog is displayed on top of the {@code Component}'s ! * frame, and is usually positioned below the {@code Component}. * ! * @param parentComponent the parent {@code Component} for the * dialog ! * @param message the {@code Object} to display * @param initialSelectionValue the value used to initialize the input * field * @return user's input * @since 1.4 */
*** 501,528 **** initialSelectionValue); } /** * Shows a dialog requesting input from the user parented to ! * <code>parentComponent</code> with the dialog having the title ! * <code>title</code> and message type <code>messageType</code>. * ! * @param parentComponent the parent <code>Component</code> for the * dialog ! * @param message the <code>Object</code> to display ! * @param title the <code>String</code> to display in the dialog * title bar * @param messageType the type of message that is to be displayed: ! * <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @return user's input * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless */ public static String showInputDialog(Component parentComponent, Object message, String title, int messageType) throws HeadlessException { --- 501,528 ---- initialSelectionValue); } /** * Shows a dialog requesting input from the user parented to ! * {@code parentComponent} with the dialog having the title ! * {@code title} and message type {@code messageType}. * ! * @param parentComponent the parent {@code Component} for the * dialog ! * @param message the {@code Object} to display ! * @param title the {@code String} to display in the dialog * title bar * @param messageType the type of message that is to be displayed: ! * {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @return user's input * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless */ public static String showInputDialog(Component parentComponent, Object message, String title, int messageType) throws HeadlessException {
*** 532,571 **** /** * 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 from ! * <code>selectionValues</code>, where <code>null</code> implies the * user can input ! * whatever they wish, usually by means of a <code>JTextField</code>. ! * <code>initialSelectionValue</code> is the initial value to prompt * the user with. It is up to the UI to decide how best to represent ! * the <code>selectionValues</code>, but usually a ! * <code>JComboBox</code>, <code>JList</code>, or ! * <code>JTextField</code> will be used. * ! * @param parentComponent the parent <code>Component</code> for the * dialog ! * @param message the <code>Object</code> to display ! * @param title the <code>String</code> to display in the * dialog title bar * @param messageType the type of message to be displayed: ! * <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> ! * @param icon the <code>Icon</code> image to display ! * @param selectionValues an array of <code>Object</code>s that * gives the possible selections * @param initialSelectionValue the value used to initialize the input * field ! * @return user's input, or <code>null</code> meaning the user * canceled the input * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless */ @SuppressWarnings("deprecation") public static Object showInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, --- 532,571 ---- /** * 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 from ! * {@code selectionValues}, where {@code null} implies the * user can input ! * whatever they wish, usually by means of a {@code JTextField}. ! * {@code initialSelectionValue} is the initial value to prompt * the user with. It is up to the UI to decide how best to represent ! * the {@code selectionValues}, but usually a ! * {@code JComboBox}, {@code JList}, or ! * {@code JTextField} will be used. * ! * @param parentComponent the parent {@code Component} for the * dialog ! * @param message the {@code Object} to display ! * @param title the {@code String} to display in the * dialog title bar * @param messageType the type of message to be displayed: ! * {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} ! * @param icon the {@code Icon} image to display ! * @param selectionValues an array of {@code Object}s that * gives the possible selections * @param initialSelectionValue the value used to initialize the input * field ! * @return user's input, or {@code null} meaning the user * canceled the input * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless */ @SuppressWarnings("deprecation") public static Object showInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon,
*** 597,614 **** } /** * Brings up an information-message dialog titled "Message". * ! * @param parentComponent determines the <code>Frame</code> in ! * which the dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a default <code>Frame</code> is used ! * @param message the <code>Object</code> to display * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless */ public static void showMessageDialog(Component parentComponent, Object message) throws HeadlessException { showMessageDialog(parentComponent, message, UIManager.getString( --- 597,614 ---- } /** * Brings up an information-message dialog titled "Message". * ! * @param parentComponent determines the {@code Frame} in ! * which the dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a default {@code Frame} is used ! * @param message the {@code Object} to display * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless */ public static void showMessageDialog(Component parentComponent, Object message) throws HeadlessException { showMessageDialog(parentComponent, message, UIManager.getString(
*** 616,642 **** INFORMATION_MESSAGE); } /** * Brings up a dialog that displays a message using a default ! * icon determined by the <code>messageType</code> parameter. * ! * @param parentComponent determines the <code>Frame</code> ! * in which the dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a default <code>Frame</code> is used ! * @param message the <code>Object</code> to display * @param title the title string for the dialog * @param messageType the type of message to be displayed: ! * <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless */ public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType) throws HeadlessException { --- 616,642 ---- INFORMATION_MESSAGE); } /** * Brings up a dialog that displays a message using a default ! * icon determined by the {@code messageType} parameter. * ! * @param parentComponent determines the {@code Frame} ! * in which the dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a default {@code Frame} is used ! * @param message the {@code Object} to display * @param title the title string for the dialog * @param messageType the type of message to be displayed: ! * {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless */ public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType) throws HeadlessException {
*** 644,671 **** } /** * Brings up a dialog displaying a message, specifying all parameters. * ! * @param parentComponent determines the <code>Frame</code> in which the ! * dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a ! * default <code>Frame</code> is used ! * @param message the <code>Object</code> to display * @param title the title string for the dialog * @param messageType the type of message to be displayed: ! * <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @param icon an icon to display in the dialog that helps the user * identify the kind of message that is being displayed * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless */ public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon) throws HeadlessException { --- 644,671 ---- } /** * Brings up a dialog displaying a message, specifying all parameters. * ! * @param parentComponent determines the {@code Frame} in which the ! * dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a ! * default {@code Frame} is used ! * @param message the {@code Object} to display * @param title the title string for the dialog * @param messageType the type of message to be displayed: ! * {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @param icon an icon to display in the dialog that helps the user * identify the kind of message that is being displayed * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless */ public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon) throws HeadlessException {
*** 676,695 **** /** * Brings up a dialog with the options <i>Yes</i>, * <i>No</i> and <i>Cancel</i>; with the * title, <b>Select an Option</b>. * ! * @param parentComponent determines the <code>Frame</code> in which the ! * dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a ! * default <code>Frame</code> is used ! * @param message the <code>Object</code> to display * @return an integer indicating the option selected by the user * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless */ public static int showConfirmDialog(Component parentComponent, Object message) throws HeadlessException { return showConfirmDialog(parentComponent, message, --- 676,695 ---- /** * Brings up a dialog with the options <i>Yes</i>, * <i>No</i> and <i>Cancel</i>; with the * title, <b>Select an Option</b>. * ! * @param parentComponent determines the {@code Frame} in which the ! * dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a ! * default {@code Frame} is used ! * @param message the {@code Object} to display * @return an integer indicating the option selected by the user * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless */ public static int showConfirmDialog(Component parentComponent, Object message) throws HeadlessException { return showConfirmDialog(parentComponent, message,
*** 697,723 **** YES_NO_CANCEL_OPTION); } /** * Brings up a dialog where the number of choices is determined ! * by the <code>optionType</code> parameter. * ! * @param parentComponent determines the <code>Frame</code> in which the ! * dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a ! * default <code>Frame</code> is used ! * @param message the <code>Object</code> to display * @param title the title string for the dialog * @param optionType an int designating the options available on the dialog: ! * <code>YES_NO_OPTION</code>, ! * <code>YES_NO_CANCEL_OPTION</code>, ! * or <code>OK_CANCEL_OPTION</code> * @return an int indicating the option selected by the user * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless */ public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType) throws HeadlessException { --- 697,723 ---- YES_NO_CANCEL_OPTION); } /** * Brings up a dialog where the number of choices is determined ! * by the {@code optionType} parameter. * ! * @param parentComponent determines the {@code Frame} in which the ! * dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a ! * default {@code Frame} is used ! * @param message the {@code Object} to display * @param title the title string for the dialog * @param optionType an int designating the options available on the dialog: ! * {@code YES_NO_OPTION}, ! * {@code YES_NO_CANCEL_OPTION}, ! * or {@code OK_CANCEL_OPTION} * @return an int indicating the option selected by the user * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless */ public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType) throws HeadlessException {
*** 725,762 **** QUESTION_MESSAGE); } /** * Brings up a dialog where the number of choices is determined ! * by the <code>optionType</code> parameter, where the ! * <code>messageType</code> * parameter determines the icon to display. ! * The <code>messageType</code> parameter is primarily used to supply * a default icon from the Look and Feel. * ! * @param parentComponent determines the <code>Frame</code> in ! * which the dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a ! * default <code>Frame</code> is used. ! * @param message the <code>Object</code> to display * @param title the title string for the dialog * @param optionType an integer designating the options available ! * on the dialog: <code>YES_NO_OPTION</code>, ! * <code>YES_NO_CANCEL_OPTION</code>, ! * or <code>OK_CANCEL_OPTION</code> * @param messageType an integer designating the kind of message this is; * primarily used to determine the icon from the pluggable ! * Look and Feel: <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @return an integer indicating the option selected by the user * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless */ public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType) throws HeadlessException { --- 725,762 ---- QUESTION_MESSAGE); } /** * Brings up a dialog where the number of choices is determined ! * by the {@code optionType} parameter, where the ! * {@code messageType} * parameter determines the icon to display. ! * The {@code messageType} parameter is primarily used to supply * a default icon from the Look and Feel. * ! * @param parentComponent determines the {@code Frame} in ! * which the dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a ! * default {@code Frame} is used. ! * @param message the {@code Object} to display * @param title the title string for the dialog * @param optionType an integer designating the options available ! * on the dialog: {@code YES_NO_OPTION}, ! * {@code YES_NO_CANCEL_OPTION}, ! * or {@code OK_CANCEL_OPTION} * @param messageType an integer designating the kind of message this is; * primarily used to determine the icon from the pluggable ! * Look and Feel: {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @return an integer indicating the option selected by the user * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless */ public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType) throws HeadlessException {
*** 764,800 **** messageType, null); } /** * Brings up a dialog with a specified icon, where the number of ! * choices is determined by the <code>optionType</code> parameter. ! * The <code>messageType</code> parameter is primarily used to supply * a default icon from the look and feel. * ! * @param parentComponent determines the <code>Frame</code> in which the ! * dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a ! * default <code>Frame</code> is used * @param message the Object to display * @param title the title string for the dialog * @param optionType an int designating the options available on the dialog: ! * <code>YES_NO_OPTION</code>, ! * <code>YES_NO_CANCEL_OPTION</code>, ! * or <code>OK_CANCEL_OPTION</code> * @param messageType an int designating the kind of message this is, * primarily used to determine the icon from the pluggable ! * Look and Feel: <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @param icon the icon to display in the dialog * @return an int indicating the option selected by the user * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless */ public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon) throws HeadlessException { --- 764,800 ---- messageType, null); } /** * Brings up a dialog with a specified icon, where the number of ! * choices is determined by the {@code optionType} parameter. ! * The {@code messageType} parameter is primarily used to supply * a default icon from the look and feel. * ! * @param parentComponent determines the {@code Frame} in which the ! * dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a ! * default {@code Frame} is used * @param message the Object to display * @param title the title string for the dialog * @param optionType an int designating the options available on the dialog: ! * {@code YES_NO_OPTION}, ! * {@code YES_NO_CANCEL_OPTION}, ! * or {@code OK_CANCEL_OPTION} * @param messageType an int designating the kind of message this is, * primarily used to determine the icon from the pluggable ! * Look and Feel: {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @param icon the icon to display in the dialog * @return an int indicating the option selected by the user * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless */ public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon) throws HeadlessException {
*** 802,861 **** messageType, icon, null, null); } /** * Brings up a dialog with a specified icon, where the initial ! * choice is determined by the <code>initialValue</code> parameter and ! * the number of choices is determined by the <code>optionType</code> * parameter. * <p> ! * If <code>optionType</code> is <code>YES_NO_OPTION</code>, ! * or <code>YES_NO_CANCEL_OPTION</code> ! * and the <code>options</code> parameter is <code>null</code>, * then the options are * supplied by the look and feel. * <p> ! * The <code>messageType</code> parameter is primarily used to supply * a default icon from the look and feel. * ! * @param parentComponent determines the <code>Frame</code> * in which the dialog is displayed; if ! * <code>null</code>, or if the ! * <code>parentComponent</code> has no ! * <code>Frame</code>, a ! * default <code>Frame</code> is used ! * @param message the <code>Object</code> to display * @param title the title string for the dialog * @param optionType an integer designating the options available on the ! * dialog: <code>DEFAULT_OPTION</code>, ! * <code>YES_NO_OPTION</code>, ! * <code>YES_NO_CANCEL_OPTION</code>, ! * or <code>OK_CANCEL_OPTION</code> * @param messageType an integer designating the kind of message this is, * primarily used to determine the icon from the ! * pluggable Look and Feel: <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @param icon the icon to display in the dialog * @param options an array of objects indicating the possible choices * the user can make; if the objects are components, they ! * are rendered properly; non-<code>String</code> * objects are ! * rendered using their <code>toString</code> methods; ! * if this parameter is <code>null</code>, * the options are determined by the Look and Feel * @param initialValue the object that represents the default selection ! * for the dialog; only meaningful if <code>options</code> ! * is used; can be <code>null</code> * @return an integer indicating the option chosen by the user, ! * or <code>CLOSED_OPTION</code> if the user closed * the dialog * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless */ @SuppressWarnings("deprecation") public static int showOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, --- 802,861 ---- messageType, icon, null, null); } /** * Brings up a dialog with a specified icon, where the initial ! * choice is determined by the {@code initialValue} parameter and ! * the number of choices is determined by the {@code optionType} * parameter. * <p> ! * If {@code optionType} is {@code YES_NO_OPTION}, ! * or {@code YES_NO_CANCEL_OPTION} ! * and the {@code options} parameter is {@code null}, * then the options are * supplied by the look and feel. * <p> ! * The {@code messageType} parameter is primarily used to supply * a default icon from the look and feel. * ! * @param parentComponent determines the {@code Frame} * in which the dialog is displayed; if ! * {@code null}, or if the ! * {@code parentComponent} has no ! * {@code Frame}, a ! * default {@code Frame} is used ! * @param message the {@code Object} to display * @param title the title string for the dialog * @param optionType an integer designating the options available on the ! * dialog: {@code DEFAULT_OPTION}, ! * {@code YES_NO_OPTION}, ! * {@code YES_NO_CANCEL_OPTION}, ! * or {@code OK_CANCEL_OPTION} * @param messageType an integer designating the kind of message this is, * primarily used to determine the icon from the ! * pluggable Look and Feel: {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @param icon the icon to display in the dialog * @param options an array of objects indicating the possible choices * the user can make; if the objects are components, they ! * are rendered properly; non-{@code String} * objects are ! * rendered using their {@code toString} methods; ! * if this parameter is {@code null}, * the options are determined by the Look and Feel * @param initialValue the object that represents the default selection ! * for the dialog; only meaningful if {@code options} ! * is used; can be {@code null} * @return an integer indicating the option chosen by the user, ! * or {@code CLOSED_OPTION} if the user closed * the dialog * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless */ @SuppressWarnings("deprecation") public static int showOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType,
*** 892,951 **** } return CLOSED_OPTION; } /** ! * Creates and returns a new <code>JDialog</code> wrapping ! * <code>this</code> centered on the <code>parentComponent</code> ! * in the <code>parentComponent</code>'s frame. ! * <code>title</code> is the title of the returned dialog. ! * The returned <code>JDialog</code> will not be resizable by the ! * user, however programs can invoke <code>setResizable</code> on ! * the <code>JDialog</code> instance to change this property. ! * The returned <code>JDialog</code> 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 to ! * <code>JOptionPane.UNINITIALIZED_VALUE</code> to ensure the * user's subsequent action closes the dialog properly. * * @param parentComponent determines the frame in which the dialog ! * is displayed; if the <code>parentComponent</code> has ! * no <code>Frame</code>, a default <code>Frame</code> is used * @param title the title string for the dialog ! * @return a new <code>JDialog</code> containing this instance * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless */ public JDialog createDialog(Component parentComponent, String title) throws HeadlessException { int style = styleFromMessageType(getMessageType()); return createDialog(parentComponent, title, style); } /** ! * Creates and returns a new parentless <code>JDialog</code> * with the specified title. ! * The returned <code>JDialog</code> will not be resizable by the ! * user, however programs can invoke <code>setResizable</code> on ! * the <code>JDialog</code> instance to change this property. ! * The returned <code>JDialog</code> 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 to ! * <code>JOptionPane.UNINITIALIZED_VALUE</code> to ensure the * user's subsequent action closes the dialog properly. * * @param title the title string for the dialog ! * @return a new <code>JDialog</code> containing this instance * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless * @since 1.6 */ public JDialog createDialog(String title) throws HeadlessException { int style = styleFromMessageType(getMessageType()); --- 892,951 ---- } return CLOSED_OPTION; } /** ! * Creates and returns a new {@code JDialog} wrapping ! * {@code this} centered on the {@code parentComponent} ! * in the {@code parentComponent}'s frame. ! * {@code title} is the title of the returned dialog. ! * The returned {@code JDialog} will not be resizable by the ! * user, however programs can invoke {@code setResizable} on ! * the {@code JDialog} instance to change this property. ! * The returned {@code JDialog} 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 to ! * {@code JOptionPane.UNINITIALIZED_VALUE} to ensure the * user's subsequent action closes the dialog properly. * * @param parentComponent determines the frame in which the dialog ! * is displayed; if the {@code parentComponent} has ! * no {@code Frame}, a default {@code Frame} is used * @param title the title string for the dialog ! * @return a new {@code JDialog} containing this instance * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless */ public JDialog createDialog(Component parentComponent, String title) throws HeadlessException { int style = styleFromMessageType(getMessageType()); return createDialog(parentComponent, title, style); } /** ! * Creates and returns a new parentless {@code JDialog} * with the specified title. ! * The returned {@code JDialog} will not be resizable by the ! * user, however programs can invoke {@code setResizable} on ! * the {@code JDialog} instance to change this property. ! * The returned {@code JDialog} 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 to ! * {@code JOptionPane.UNINITIALIZED_VALUE} to ensure the * user's subsequent action closes the dialog properly. * * @param title the title string for the dialog ! * @return a new {@code JDialog} containing this instance * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless * @since 1.6 */ public JDialog createDialog(String title) throws HeadlessException { int style = styleFromMessageType(getMessageType());
*** 1041,1054 **** /** * Brings up an internal confirmation dialog panel. The dialog * is a information-message dialog titled "Message". * ! * @param parentComponent determines the <code>Frame</code> ! * in which the dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a default <code>Frame</code> is used * @param message the object to display */ public static void showInternalMessageDialog(Component parentComponent, Object message) { showInternalMessageDialog(parentComponent, message, UIManager. --- 1041,1054 ---- /** * Brings up an internal confirmation dialog panel. The dialog * is a information-message dialog titled "Message". * ! * @param parentComponent determines the {@code Frame} ! * in which the dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a default {@code Frame} is used * @param message the object to display */ public static void showInternalMessageDialog(Component parentComponent, Object message) { showInternalMessageDialog(parentComponent, message, UIManager.
*** 1056,1080 **** parentComponent), INFORMATION_MESSAGE); } /** * Brings up an internal dialog panel that displays a message ! * using a default icon determined by the <code>messageType</code> * parameter. * ! * @param parentComponent determines the <code>Frame</code> ! * in which the dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a default <code>Frame</code> is used ! * @param message the <code>Object</code> to display * @param title the title string for the dialog * @param messageType the type of message to be displayed: ! * <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> */ public static void showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType) { showInternalMessageDialog(parentComponent, message, title, messageType,null); --- 1056,1080 ---- parentComponent), INFORMATION_MESSAGE); } /** * Brings up an internal dialog panel that displays a message ! * using a default icon determined by the {@code messageType} * parameter. * ! * @param parentComponent determines the {@code Frame} ! * in which the dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a default {@code Frame} is used ! * @param message the {@code Object} to display * @param title the title string for the dialog * @param messageType the type of message to be displayed: ! * {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} */ public static void showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType) { showInternalMessageDialog(parentComponent, message, title, messageType,null);
*** 1082,1103 **** /** * Brings up an internal dialog panel displaying a message, * specifying all parameters. * ! * @param parentComponent determines the <code>Frame</code> ! * in which the dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a default <code>Frame</code> is used ! * @param message the <code>Object</code> to display * @param title the title string for the dialog * @param messageType the type of message to be displayed: ! * <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @param icon an icon to display in the dialog that helps the user * identify the kind of message that is being displayed */ public static void showInternalMessageDialog(Component parentComponent, Object message, --- 1082,1103 ---- /** * Brings up an internal dialog panel displaying a message, * specifying all parameters. * ! * @param parentComponent determines the {@code Frame} ! * in which the dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a default {@code Frame} is used ! * @param message the {@code Object} to display * @param title the title string for the dialog * @param messageType the type of message to be displayed: ! * {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @param icon an icon to display in the dialog that helps the user * identify the kind of message that is being displayed */ public static void showInternalMessageDialog(Component parentComponent, Object message,
*** 1109,1123 **** /** * Brings up an internal dialog panel with the options <i>Yes</i>, <i>No</i> * and <i>Cancel</i>; with the title, <b>Select an Option</b>. * ! * @param parentComponent determines the <code>Frame</code> in ! * which the dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a default <code>Frame</code> is used ! * @param message the <code>Object</code> to display * @return an integer indicating the option selected by the user */ public static int showInternalConfirmDialog(Component parentComponent, Object message) { return showInternalConfirmDialog(parentComponent, message, --- 1109,1123 ---- /** * Brings up an internal dialog panel with the options <i>Yes</i>, <i>No</i> * and <i>Cancel</i>; with the title, <b>Select an Option</b>. * ! * @param parentComponent determines the {@code Frame} in ! * which the dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a default {@code Frame} is used ! * @param message the {@code Object} to display * @return an integer indicating the option selected by the user */ public static int showInternalConfirmDialog(Component parentComponent, Object message) { return showInternalConfirmDialog(parentComponent, message,
*** 1125,1150 **** YES_NO_CANCEL_OPTION); } /** * Brings up a internal dialog panel where the number of choices ! * is determined by the <code>optionType</code> parameter. * ! * @param parentComponent determines the <code>Frame</code> ! * in which the dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a default <code>Frame</code> is used * @param message the object to display in the dialog; a ! * <code>Component</code> object is rendered as a ! * <code>Component</code>; a <code>String</code> * object is rendered as a string; other objects ! * are converted to a <code>String</code> using the ! * <code>toString</code> method * @param title the title string for the dialog * @param optionType an integer designating the options ! * available on the dialog: <code>YES_NO_OPTION</code>, ! * or <code>YES_NO_CANCEL_OPTION</code> * @return an integer indicating the option selected by the user */ public static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType) { --- 1125,1150 ---- YES_NO_CANCEL_OPTION); } /** * Brings up a internal dialog panel where the number of choices ! * is determined by the {@code optionType} parameter. * ! * @param parentComponent determines the {@code Frame} ! * in which the dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a default {@code Frame} is used * @param message the object to display in the dialog; a ! * {@code Component} object is rendered as a ! * {@code Component}; a {@code String} * object is rendered as a string; other objects ! * are converted to a {@code String} using the ! * {@code toString} method * @param title the title string for the dialog * @param optionType an integer designating the options ! * available on the dialog: {@code YES_NO_OPTION}, ! * or {@code YES_NO_CANCEL_OPTION} * @return an integer indicating the option selected by the user */ public static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType) {
*** 1152,1186 **** QUESTION_MESSAGE); } /** * Brings up an internal dialog panel where the number of choices ! * is determined by the <code>optionType</code> parameter, where ! * the <code>messageType</code> parameter determines the icon to display. ! * The <code>messageType</code> parameter is primarily used to supply * a default icon from the Look and Feel. * ! * @param parentComponent determines the <code>Frame</code> in ! * which the dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a default <code>Frame</code> is used * @param message the object to display in the dialog; a ! * <code>Component</code> object is rendered as a ! * <code>Component</code>; a <code>String</code> * object is rendered as a string; other objects are ! * converted to a <code>String</code> using the ! * <code>toString</code> method * @param title the title string for the dialog * @param optionType an integer designating the options * available on the dialog: ! * <code>YES_NO_OPTION</code>, or <code>YES_NO_CANCEL_OPTION</code> * @param messageType an integer designating the kind of message this is, * primarily used to determine the icon from the ! * pluggable Look and Feel: <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @return an integer indicating the option selected by the user */ public static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, --- 1152,1186 ---- QUESTION_MESSAGE); } /** * Brings up an internal dialog panel where the number of choices ! * is determined by the {@code optionType} parameter, where ! * the {@code messageType} parameter determines the icon to display. ! * The {@code messageType} parameter is primarily used to supply * a default icon from the Look and Feel. * ! * @param parentComponent determines the {@code Frame} in ! * which the dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a default {@code Frame} is used * @param message the object to display in the dialog; a ! * {@code Component} object is rendered as a ! * {@code Component}; a {@code String} * object is rendered as a string; other objects are ! * converted to a {@code String} using the ! * {@code toString} method * @param title the title string for the dialog * @param optionType an integer designating the options * available on the dialog: ! * {@code YES_NO_OPTION}, or {@code YES_NO_CANCEL_OPTION} * @param messageType an integer designating the kind of message this is, * primarily used to determine the icon from the ! * pluggable Look and Feel: {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @return an integer indicating the option selected by the user */ public static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType,
*** 1189,1224 **** messageType, null); } /** * Brings up an internal dialog panel with a specified icon, where ! * the number of choices is determined by the <code>optionType</code> * parameter. ! * The <code>messageType</code> parameter is primarily used to supply * a default icon from the look and feel. * ! * @param parentComponent determines the <code>Frame</code> ! * in which the dialog is displayed; if <code>null</code>, * or if the parentComponent has no Frame, a ! * default <code>Frame</code> is used * @param message the object to display in the dialog; a ! * <code>Component</code> object is rendered as a ! * <code>Component</code>; a <code>String</code> * object is rendered as a string; other objects are ! * converted to a <code>String</code> using the ! * <code>toString</code> method * @param title the title string for the dialog * @param optionType an integer designating the options available * on the dialog: ! * <code>YES_NO_OPTION</code>, or ! * <code>YES_NO_CANCEL_OPTION</code>. * @param messageType an integer designating the kind of message this is, * primarily used to determine the icon from the pluggable ! * Look and Feel: <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @param icon the icon to display in the dialog * @return an integer indicating the option selected by the user */ public static int showInternalConfirmDialog(Component parentComponent, Object message, --- 1189,1224 ---- messageType, null); } /** * Brings up an internal dialog panel with a specified icon, where ! * the number of choices is determined by the {@code optionType} * parameter. ! * The {@code messageType} parameter is primarily used to supply * a default icon from the look and feel. * ! * @param parentComponent determines the {@code Frame} ! * in which the dialog is displayed; if {@code null}, * or if the parentComponent has no Frame, a ! * default {@code Frame} is used * @param message the object to display in the dialog; a ! * {@code Component} object is rendered as a ! * {@code Component}; a {@code String} * object is rendered as a string; other objects are ! * converted to a {@code String} using the ! * {@code toString} method * @param title the title string for the dialog * @param optionType an integer designating the options available * on the dialog: ! * {@code YES_NO_OPTION}, or ! * {@code YES_NO_CANCEL_OPTION}. * @param messageType an integer designating the kind of message this is, * primarily used to determine the icon from the pluggable ! * Look and Feel: {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @param icon the icon to display in the dialog * @return an integer indicating the option selected by the user */ public static int showInternalConfirmDialog(Component parentComponent, Object message,
*** 1228,1281 **** messageType, icon, null, null); } /** * Brings up an internal dialog panel with a specified icon, where ! * the initial choice is determined by the <code>initialValue</code> * parameter and the number of choices is determined by the ! * <code>optionType</code> parameter. * <p> ! * If <code>optionType</code> is <code>YES_NO_OPTION</code>, or ! * <code>YES_NO_CANCEL_OPTION</code> ! * and the <code>options</code> parameter is <code>null</code>, * then the options are supplied by the Look and Feel. * <p> ! * The <code>messageType</code> parameter is primarily used to supply * a default icon from the look and feel. * ! * @param parentComponent determines the <code>Frame</code> ! * in which the dialog is displayed; if <code>null</code>, ! * or if the <code>parentComponent</code> has no ! * <code>Frame</code>, a default <code>Frame</code> is used * @param message the object to display in the dialog; a ! * <code>Component</code> object is rendered as a ! * <code>Component</code>; a <code>String</code> * object is rendered as a string. Other objects are ! * converted to a <code>String</code> using the ! * <code>toString</code> method * @param title the title string for the dialog * @param optionType an integer designating the options available ! * on the dialog: <code>YES_NO_OPTION</code>, ! * or <code>YES_NO_CANCEL_OPTION</code> * @param messageType an integer designating the kind of message this is; * primarily used to determine the icon from the ! * pluggable Look and Feel: <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @param icon the icon to display in the dialog * @param options an array of objects indicating the possible choices * the user can make; if the objects are components, they ! * are rendered properly; non-<code>String</code> ! * objects are rendered using their <code>toString</code> ! * methods; if this parameter is <code>null</code>, * the options are determined by the Look and Feel * @param initialValue the object that represents the default selection ! * for the dialog; only meaningful if <code>options</code> ! * is used; can be <code>null</code> * @return an integer indicating the option chosen by the user, ! * or <code>CLOSED_OPTION</code> if the user closed the Dialog */ public static int showInternalOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, --- 1228,1281 ---- messageType, icon, null, null); } /** * Brings up an internal dialog panel with a specified icon, where ! * the initial choice is determined by the {@code initialValue} * parameter and the number of choices is determined by the ! * {@code optionType} parameter. * <p> ! * If {@code optionType} is {@code YES_NO_OPTION}, or ! * {@code YES_NO_CANCEL_OPTION} ! * and the {@code options} parameter is {@code null}, * then the options are supplied by the Look and Feel. * <p> ! * The {@code messageType} parameter is primarily used to supply * a default icon from the look and feel. * ! * @param parentComponent determines the {@code Frame} ! * in which the dialog is displayed; if {@code null}, ! * or if the {@code parentComponent} has no ! * {@code Frame}, a default {@code Frame} is used * @param message the object to display in the dialog; a ! * {@code Component} object is rendered as a ! * {@code Component}; a {@code String} * object is rendered as a string. Other objects are ! * converted to a {@code String} using the ! * {@code toString} method * @param title the title string for the dialog * @param optionType an integer designating the options available ! * on the dialog: {@code YES_NO_OPTION}, ! * or {@code YES_NO_CANCEL_OPTION} * @param messageType an integer designating the kind of message this is; * primarily used to determine the icon from the ! * pluggable Look and Feel: {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @param icon the icon to display in the dialog * @param options an array of objects indicating the possible choices * the user can make; if the objects are components, they ! * are rendered properly; non-{@code String} ! * objects are rendered using their {@code toString} ! * methods; if this parameter is {@code null}, * the options are determined by the Look and Feel * @param initialValue the object that represents the default selection ! * for the dialog; only meaningful if {@code options} ! * is used; can be {@code null} * @return an integer indicating the option chosen by the user, ! * or {@code CLOSED_OPTION} if the user closed the Dialog */ public static int showInternalOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon,
*** 1344,1360 **** return CLOSED_OPTION; } /** * Shows an internal question-message dialog requesting input from ! * the user parented to <code>parentComponent</code>. The dialog ! * is displayed in the <code>Component</code>'s frame, ! * and is usually positioned below the <code>Component</code>. * ! * @param parentComponent the parent <code>Component</code> * for the dialog ! * @param message the <code>Object</code> to display * @return user's input */ public static String showInternalInputDialog(Component parentComponent, Object message) { return showInternalInputDialog(parentComponent, message, UIManager. --- 1344,1360 ---- return CLOSED_OPTION; } /** * Shows an internal question-message dialog requesting input from ! * the user parented to {@code parentComponent}. The dialog ! * is displayed in the {@code Component}'s frame, ! * and is usually positioned below the {@code Component}. * ! * @param parentComponent the parent {@code Component} * for the dialog ! * @param message the {@code Object} to display * @return user's input */ public static String showInternalInputDialog(Component parentComponent, Object message) { return showInternalInputDialog(parentComponent, message, UIManager.
*** 1362,1377 **** QUESTION_MESSAGE); } /** * Shows an internal dialog requesting input from the user parented ! * to <code>parentComponent</code> with the dialog having the title ! * <code>title</code> and message type <code>messageType</code>. * ! * @param parentComponent the parent <code>Component</code> for the dialog ! * @param message the <code>Object</code> to display ! * @param title the <code>String</code> to display in the * dialog title bar * @param messageType the type of message that is to be displayed: * ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, * QUESTION_MESSAGE, or PLAIN_MESSAGE * @return user's input --- 1362,1377 ---- QUESTION_MESSAGE); } /** * Shows an internal dialog requesting input from the user parented ! * to {@code parentComponent} with the dialog having the title ! * {@code title} and message type {@code messageType}. * ! * @param parentComponent the parent {@code Component} for the dialog ! * @param message the {@code Object} to display ! * @param title the {@code String} to display in the * dialog title bar * @param messageType the type of message that is to be displayed: * ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, * QUESTION_MESSAGE, or PLAIN_MESSAGE * @return user's input
*** 1384,1416 **** /** * Prompts the user for input in a blocking internal dialog where * the initial selection, possible selections, and all other * options can be specified. The user will able to choose from ! * <code>selectionValues</code>, where <code>null</code> * implies the user can input ! * whatever they wish, usually by means of a <code>JTextField</code>. ! * <code>initialSelectionValue</code> is the initial value to prompt * the user with. It is up to the UI to decide how best to represent ! * the <code>selectionValues</code>, but usually a ! * <code>JComboBox</code>, <code>JList</code>, or ! * <code>JTextField</code> will be used. ! * ! * @param parentComponent the parent <code>Component</code> for the dialog ! * @param message the <code>Object</code> to display ! * @param title the <code>String</code> to display in the dialog * title bar * @param messageType the type of message to be displayed: ! * <code>ERROR_MESSAGE</code>, <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, or <code>PLAIN_MESSAGE</code> ! * @param icon the <code>Icon</code> image to display ! * @param selectionValues an array of <code>Objects</code> that * gives the possible selections * @param initialSelectionValue the value used to initialize the input * field ! * @return user's input, or <code>null</code> meaning the user * canceled the input */ public static Object showInternalInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue) { --- 1384,1416 ---- /** * Prompts the user for input in a blocking internal dialog where * the initial selection, possible selections, and all other * options can be specified. The user will able to choose from ! * {@code selectionValues}, where {@code null} * implies the user can input ! * whatever they wish, usually by means of a {@code JTextField}. ! * {@code initialSelectionValue} is the initial value to prompt * the user with. It is up to the UI to decide how best to represent ! * the {@code selectionValues}, but usually a ! * {@code JComboBox}, {@code JList}, or ! * {@code JTextField} will be used. ! * ! * @param parentComponent the parent {@code Component} for the dialog ! * @param message the {@code Object} to display ! * @param title the {@code String} to display in the dialog * title bar * @param messageType the type of message to be displayed: ! * {@code ERROR_MESSAGE}, {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, or {@code PLAIN_MESSAGE} ! * @param icon the {@code Icon} image to display ! * @param selectionValues an array of {@code Objects} that * gives the possible selections * @param initialSelectionValue the value used to initialize the input * field ! * @return user's input, or {@code null} meaning the user * canceled the input */ public static Object showInternalInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue) {
*** 1468,1494 **** } return value; } /** ! * Creates and returns an instance of <code>JInternalFrame</code>. * The internal frame is created with the specified title, ! * and wrapping the <code>JOptionPane</code>. ! * The returned <code>JInternalFrame</code> is ! * added to the <code>JDesktopPane</code> ancestor of ! * <code>parentComponent</code>, or components ! * parent if one its ancestors isn't a <code>JDesktopPane</code>, ! * or if <code>parentComponent</code> ! * doesn't have a parent then a <code>RuntimeException</code> is thrown. * ! * @param parentComponent the parent <code>Component</code> for * the internal frame ! * @param title the <code>String</code> to display in the * frame's title bar ! * @return a <code>JInternalFrame</code> containing a ! * <code>JOptionPane</code> ! * @exception RuntimeException if <code>parentComponent</code> does * not have a valid parent */ public JInternalFrame createInternalFrame(Component parentComponent, String title) { Container parent = --- 1468,1494 ---- } return value; } /** ! * Creates and returns an instance of {@code JInternalFrame}. * The internal frame is created with the specified title, ! * and wrapping the {@code JOptionPane}. ! * The returned {@code JInternalFrame} is ! * added to the {@code JDesktopPane} ancestor of ! * {@code parentComponent}, or components ! * parent if one its ancestors isn't a {@code JDesktopPane}, ! * or if {@code parentComponent} ! * doesn't have a parent then a {@code RuntimeException} is thrown. * ! * @param parentComponent the parent {@code Component} for * the internal frame ! * @param title the {@code String} to display in the * frame's title bar ! * @return a {@code JInternalFrame} containing a ! * {@code JOptionPane} ! * @exception RuntimeException if {@code parentComponent} does * not have a valid parent */ public JInternalFrame createInternalFrame(Component parentComponent, String title) { Container parent =
*** 1568,1588 **** return iFrame; } /** ! * Returns the specified component's <code>Frame</code>. * ! * @param parentComponent the <code>Component</code> to check for a ! * <code>Frame</code> ! * @return the <code>Frame</code> that contains the component, ! * or <code>getRootFrame</code> ! * if the component is <code>null</code>, ! * or does not have a valid <code>Frame</code> parent * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see #getRootFrame * @see java.awt.GraphicsEnvironment#isHeadless */ public static Frame getFrameForComponent(Component parentComponent) throws HeadlessException { --- 1568,1588 ---- return iFrame; } /** ! * Returns the specified component's {@code Frame}. * ! * @param parentComponent the {@code Component} to check for a ! * {@code Frame} ! * @return the {@code Frame} that contains the component, ! * or {@code getRootFrame} ! * if the component is {@code null}, ! * or does not have a valid {@code Frame} parent * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see #getRootFrame * @see java.awt.GraphicsEnvironment#isHeadless */ public static Frame getFrameForComponent(Component parentComponent) throws HeadlessException {
*** 1592,1614 **** return (Frame)parentComponent; return JOptionPane.getFrameForComponent(parentComponent.getParent()); } /** ! * Returns the specified component's toplevel <code>Frame</code> or ! * <code>Dialog</code>. * ! * @param parentComponent the <code>Component</code> to check for a ! * <code>Frame</code> or <code>Dialog</code> ! * @return the <code>Frame</code> or <code>Dialog</code> that * contains the component, or the default ! * frame if the component is <code>null</code>, * or does not have a valid ! * <code>Frame</code> or <code>Dialog</code> parent * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see java.awt.GraphicsEnvironment#isHeadless */ static Window getWindowForComponent(Component parentComponent) throws HeadlessException { if (parentComponent == null) --- 1592,1614 ---- return (Frame)parentComponent; return JOptionPane.getFrameForComponent(parentComponent.getParent()); } /** ! * Returns the specified component's toplevel {@code Frame} or ! * {@code Dialog}. * ! * @param parentComponent the {@code Component} to check for a ! * {@code Frame} or {@code Dialog} ! * @return the {@code Frame} or {@code Dialog} that * contains the component, or the default ! * frame if the component is {@code null}, * or does not have a valid ! * {@code Frame} or {@code Dialog} parent * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see java.awt.GraphicsEnvironment#isHeadless */ static Window getWindowForComponent(Component parentComponent) throws HeadlessException { if (parentComponent == null)
*** 1620,1635 **** /** * Returns the specified component's desktop pane. * ! * @param parentComponent the <code>Component</code> to check for a * desktop ! * @return the <code>JDesktopPane</code> that contains the component, ! * or <code>null</code> if the component is <code>null</code> * or does not have an ancestor that is a ! * <code>JInternalFrame</code> */ public static JDesktopPane getDesktopPaneForComponent(Component parentComponent) { if(parentComponent == null) return null; if(parentComponent instanceof JDesktopPane) --- 1620,1635 ---- /** * Returns the specified component's desktop pane. * ! * @param parentComponent the {@code Component} to check for a * desktop ! * @return the {@code JDesktopPane} that contains the component, ! * or {@code null} if the component is {@code null} * or does not have an ancestor that is a ! * {@code JInternalFrame} */ public static JDesktopPane getDesktopPaneForComponent(Component parentComponent) { if(parentComponent == null) return null; if(parentComponent instanceof JDesktopPane)
*** 1644,1671 **** * not provided. * <p> * <strong>Note:</strong> * It is recommended that rather than using this method you supply a valid parent. * ! * @param newRootFrame the default <code>Frame</code> to use */ public static void setRootFrame(Frame newRootFrame) { if (newRootFrame != null) { SwingUtilities.appContextPut(sharedFrameKey, newRootFrame); } else { SwingUtilities.appContextRemove(sharedFrameKey); } } /** ! * Returns the <code>Frame</code> to use for the class methods in * which a frame is not provided. * ! * @return the default <code>Frame</code> to use * @exception HeadlessException if ! * <code>GraphicsEnvironment.isHeadless</code> returns ! * <code>true</code> * @see #setRootFrame * @see java.awt.GraphicsEnvironment#isHeadless */ public static Frame getRootFrame() throws HeadlessException { Frame sharedFrame = --- 1644,1671 ---- * not provided. * <p> * <strong>Note:</strong> * It is recommended that rather than using this method you supply a valid parent. * ! * @param newRootFrame the default {@code Frame} to use */ public static void setRootFrame(Frame newRootFrame) { if (newRootFrame != null) { SwingUtilities.appContextPut(sharedFrameKey, newRootFrame); } else { SwingUtilities.appContextRemove(sharedFrameKey); } } /** ! * Returns the {@code Frame} to use for the class methods in * which a frame is not provided. * ! * @return the default {@code Frame} to use * @exception HeadlessException if ! * {@code GraphicsEnvironment.isHeadless} returns ! * {@code true} * @see #setRootFrame * @see java.awt.GraphicsEnvironment#isHeadless */ public static Frame getRootFrame() throws HeadlessException { Frame sharedFrame =
*** 1676,1815 **** } return sharedFrame; } /** ! * Creates a <code>JOptionPane</code> with a test message. */ public JOptionPane() { this("JOptionPane message"); } /** ! * Creates a instance of <code>JOptionPane</code> to display a * message using the * plain-message message type and the default options delivered by * the UI. * ! * @param message the <code>Object</code> to display */ public JOptionPane(Object message) { this(message, PLAIN_MESSAGE); } /** ! * Creates an instance of <code>JOptionPane</code> to display a message * with the specified message type and the default options, * ! * @param message the <code>Object</code> to display * @param messageType the type of message to be displayed: ! * <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> */ public JOptionPane(Object message, int messageType) { this(message, messageType, DEFAULT_OPTION); } /** ! * Creates an instance of <code>JOptionPane</code> to display a message * with the specified message type and options. * ! * @param message the <code>Object</code> to display * @param messageType the type of message to be displayed: ! * <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @param optionType the options to display in the pane: ! * <code>DEFAULT_OPTION</code>, <code>YES_NO_OPTION</code>, ! * <code>YES_NO_CANCEL_OPTION</code>, ! * <code>OK_CANCEL_OPTION</code> */ public JOptionPane(Object message, int messageType, int optionType) { this(message, messageType, optionType, null); } /** ! * Creates an instance of <code>JOptionPane</code> to display a message * with the specified message type, options, and icon. * ! * @param message the <code>Object</code> to display * @param messageType the type of message to be displayed: ! * <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @param optionType the options to display in the pane: ! * <code>DEFAULT_OPTION</code>, <code>YES_NO_OPTION</code>, ! * <code>YES_NO_CANCEL_OPTION</code>, ! * <code>OK_CANCEL_OPTION</code> ! * @param icon the <code>Icon</code> image to display */ public JOptionPane(Object message, int messageType, int optionType, Icon icon) { this(message, messageType, optionType, icon, null); } /** ! * Creates an instance of <code>JOptionPane</code> to display a message * with the specified message type, icon, and options. * None of the options is initially selected. * <p> * The options objects should contain either instances of ! * <code>Component</code>s, (which are added directly) or ! * <code>Strings</code> (which are wrapped in a <code>JButton</code>). ! * If you provide <code>Component</code>s, you must ensure that when the ! * <code>Component</code> is clicked it messages <code>setValue</code> ! * in the created <code>JOptionPane</code>. * ! * @param message the <code>Object</code> to display * @param messageType the type of message to be displayed: ! * <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @param optionType the options to display in the pane: ! * <code>DEFAULT_OPTION</code>, ! * <code>YES_NO_OPTION</code>, ! * <code>YES_NO_CANCEL_OPTION</code>, ! * <code>OK_CANCEL_OPTION</code> ! * @param icon the <code>Icon</code> image to display * @param options the choices the user can select */ public JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options) { this(message, messageType, optionType, icon, options, null); } /** ! * Creates an instance of <code>JOptionPane</code> to display a message * with the specified message type, icon, and options, with the * initially-selected option specified. * ! * @param message the <code>Object</code> to display * @param messageType the type of message to be displayed: ! * <code>ERROR_MESSAGE</code>, ! * <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, ! * or <code>PLAIN_MESSAGE</code> * @param optionType the options to display in the pane: ! * <code>DEFAULT_OPTION</code>, ! * <code>YES_NO_OPTION</code>, ! * <code>YES_NO_CANCEL_OPTION</code>, ! * <code>OK_CANCEL_OPTION</code> * @param icon the Icon image to display * @param options the choices the user can select * @param initialValue the choice that is initially selected; if ! * <code>null</code>, then nothing will be initially selected; ! * only meaningful if <code>options</code> is used */ public JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options, Object initialValue) { this.message = message; --- 1676,1815 ---- } return sharedFrame; } /** ! * Creates a {@code JOptionPane} with a test message. */ public JOptionPane() { this("JOptionPane message"); } /** ! * Creates a instance of {@code JOptionPane} to display a * message using the * plain-message message type and the default options delivered by * the UI. * ! * @param message the {@code Object} to display */ public JOptionPane(Object message) { this(message, PLAIN_MESSAGE); } /** ! * Creates an instance of {@code JOptionPane} to display a message * with the specified message type and the default options, * ! * @param message the {@code Object} to display * @param messageType the type of message to be displayed: ! * {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} */ public JOptionPane(Object message, int messageType) { this(message, messageType, DEFAULT_OPTION); } /** ! * Creates an instance of {@code JOptionPane} to display a message * with the specified message type and options. * ! * @param message the {@code Object} to display * @param messageType the type of message to be displayed: ! * {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @param optionType the options to display in the pane: ! * {@code DEFAULT_OPTION}, {@code YES_NO_OPTION}, ! * {@code YES_NO_CANCEL_OPTION}, ! * {@code OK_CANCEL_OPTION} */ public JOptionPane(Object message, int messageType, int optionType) { this(message, messageType, optionType, null); } /** ! * Creates an instance of {@code JOptionPane} to display a message * with the specified message type, options, and icon. * ! * @param message the {@code Object} to display * @param messageType the type of message to be displayed: ! * {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @param optionType the options to display in the pane: ! * {@code DEFAULT_OPTION}, {@code YES_NO_OPTION}, ! * {@code YES_NO_CANCEL_OPTION}, ! * {@code OK_CANCEL_OPTION} ! * @param icon the {@code Icon} image to display */ public JOptionPane(Object message, int messageType, int optionType, Icon icon) { this(message, messageType, optionType, icon, null); } /** ! * Creates an instance of {@code JOptionPane} to display a message * with the specified message type, icon, and options. * None of the options is initially selected. * <p> * The options objects should contain either instances of ! * {@code Component}s, (which are added directly) or ! * {@code Strings} (which are wrapped in a {@code JButton}). ! * If you provide {@code Component}s, you must ensure that when the ! * {@code Component} is clicked it messages {@code setValue} ! * in the created {@code JOptionPane}. * ! * @param message the {@code Object} to display * @param messageType the type of message to be displayed: ! * {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @param optionType the options to display in the pane: ! * {@code DEFAULT_OPTION}, ! * {@code YES_NO_OPTION}, ! * {@code YES_NO_CANCEL_OPTION}, ! * {@code OK_CANCEL_OPTION} ! * @param icon the {@code Icon} image to display * @param options the choices the user can select */ public JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options) { this(message, messageType, optionType, icon, options, null); } /** ! * Creates an instance of {@code JOptionPane} to display a message * with the specified message type, icon, and options, with the * initially-selected option specified. * ! * @param message the {@code Object} to display * @param messageType the type of message to be displayed: ! * {@code ERROR_MESSAGE}, ! * {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, ! * or {@code PLAIN_MESSAGE} * @param optionType the options to display in the pane: ! * {@code DEFAULT_OPTION}, ! * {@code YES_NO_OPTION}, ! * {@code YES_NO_CANCEL_OPTION}, ! * {@code OK_CANCEL_OPTION} * @param icon the Icon image to display * @param options the choices the user can select * @param initialValue the choice that is initially selected; if ! * {@code null}, then nothing will be initially selected; ! * only meaningful if {@code options} is used */ public JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options, Object initialValue) { this.message = message;
*** 1824,1834 **** } /** * Sets the UI object which implements the {@literal L&F} for this component. * ! * @param ui the <code>OptionPaneUI</code> {@literal L&F} object * @see UIDefaults#getUI * @beaninfo * bound: true * hidden: true * description: The UI object that implements the optionpane's LookAndFeel --- 1824,1834 ---- } /** * Sets the UI object which implements the {@literal L&F} for this component. * ! * @param ui the {@code OptionPaneUI} {@literal L&F} object * @see UIDefaults#getUI * @beaninfo * bound: true * hidden: true * description: The UI object that implements the optionpane's LookAndFeel
*** 1841,1860 **** } /** * Returns the UI object which implements the {@literal L&F} for this component. * ! * @return the <code>OptionPaneUI</code> object */ public OptionPaneUI getUI() { return (OptionPaneUI)ui; } /** ! * Notification from the <code>UIManager</code> that the {@literal L&F} has changed. * Replaces the current UI object with the latest version from the ! * <code>UIManager</code>. * * @see JComponent#updateUI */ public void updateUI() { setUI((OptionPaneUI)UIManager.getUI(this)); --- 1841,1860 ---- } /** * Returns the UI object which implements the {@literal L&F} for this component. * ! * @return the {@code OptionPaneUI} object */ public OptionPaneUI getUI() { return (OptionPaneUI)ui; } /** ! * Notification from the {@code UIManager} that the {@literal L&F} has changed. * Replaces the current UI object with the latest version from the ! * {@code UIManager}. * * @see JComponent#updateUI */ public void updateUI() { setUI((OptionPaneUI)UIManager.getUI(this));
*** 1874,1884 **** } /** * Sets the option pane's message-object. ! * @param newMessage the <code>Object</code> to display * @see #getMessage * * @beaninfo * preferred: true * bound: true --- 1874,1884 ---- } /** * Sets the option pane's message-object. ! * @param newMessage the {@code Object} to display * @see #getMessage * * @beaninfo * preferred: true * bound: true
*** 1893,1912 **** /** * Returns the message-object this pane displays. * @see #setMessage * ! * @return the <code>Object</code> that is displayed */ public Object getMessage() { return message; } /** ! * Sets the icon to display. If non-<code>null</code>, the look and feel * does not provide an icon. ! * @param newIcon the <code>Icon</code> to display * * @see #getIcon * @beaninfo * preferred: true * bound: true --- 1893,1912 ---- /** * Returns the message-object this pane displays. * @see #setMessage * ! * @return the {@code Object} that is displayed */ public Object getMessage() { return message; } /** ! * Sets the icon to display. If non-{@code null}, the look and feel * does not provide an icon. ! * @param newIcon the {@code Icon} to display * * @see #getIcon * @beaninfo * preferred: true * bound: true
*** 1919,1929 **** firePropertyChange(ICON_PROPERTY, oldIcon, icon); } /** * Returns the icon this pane displays. ! * @return the <code>Icon</code> that is displayed * * @see #setIcon */ public Icon getIcon() { return icon; --- 1919,1929 ---- firePropertyChange(ICON_PROPERTY, oldIcon, icon); } /** * Returns the icon this pane displays. ! * @return the {@code Icon} that is displayed * * @see #setIcon */ public Icon getIcon() { return icon;
*** 1945,1980 **** value = newValue; firePropertyChange(VALUE_PROPERTY, oldValue, value); } /** ! * Returns the value the user has selected. <code>UNINITIALIZED_VALUE</code> ! * implies the user has not yet made a choice, <code>null</code> means the * user closed the window with out choosing anything. Otherwise * the returned value will be one of the options defined in this * object. * ! * @return the <code>Object</code> chosen by the user, ! * <code>UNINITIALIZED_VALUE</code> ! * if the user has not yet made a choice, or <code>null</code> if * the user closed the window without making a choice * * @see #setValue */ public Object getValue() { return value; } /** * Sets the options this pane displays. If an element in ! * <code>newOptions</code> is a <code>Component</code> * it is added directly to the pane, * otherwise a button is created for the element. * ! * @param newOptions an array of <code>Objects</code> that create the * buttons the user can click on, or arbitrary ! * <code>Components</code> to add to the pane * * @see #getOptions * @beaninfo * bound: true * description: The option pane's options objects. --- 1945,1980 ---- value = newValue; firePropertyChange(VALUE_PROPERTY, oldValue, value); } /** ! * Returns the value the user has selected. {@code UNINITIALIZED_VALUE} ! * implies the user has not yet made a choice, {@code null} means the * user closed the window with out choosing anything. Otherwise * the returned value will be one of the options defined in this * object. * ! * @return the {@code Object} chosen by the user, ! * {@code UNINITIALIZED_VALUE} ! * if the user has not yet made a choice, or {@code null} if * the user closed the window without making a choice * * @see #setValue */ public Object getValue() { return value; } /** * Sets the options this pane displays. If an element in ! * {@code newOptions} is a {@code Component} * it is added directly to the pane, * otherwise a button is created for the element. * ! * @param newOptions an array of {@code Objects} that create the * buttons the user can click on, or arbitrary ! * {@code Components} to add to the pane * * @see #getOptions * @beaninfo * bound: true * description: The option pane's options objects.
*** 1986,1996 **** firePropertyChange(OPTIONS_PROPERTY, oldOptions, options); } /** * Returns the choices the user can make. ! * @return the array of <code>Objects</code> that give the user's choices * * @see #setOptions */ public Object[] getOptions() { if(options != null) { --- 1986,1996 ---- firePropertyChange(OPTIONS_PROPERTY, oldOptions, options); } /** * Returns the choices the user can make. ! * @return the array of {@code Objects} that give the user's choices * * @see #setOptions */ public Object[] getOptions() { if(options != null) {
*** 2003,2016 **** return options; } /** * Sets the initial value that is to be enabled -- the ! * <code>Component</code> * that has the focus when the pane is initially displayed. * ! * @param newInitialValue the <code>Object</code> that gets the initial * keyboard focus * * @see #getInitialValue * @beaninfo * preferred: true --- 2003,2016 ---- return options; } /** * Sets the initial value that is to be enabled -- the ! * {@code Component} * that has the focus when the pane is initially displayed. * ! * @param newInitialValue the {@code Object} that gets the initial * keyboard focus * * @see #getInitialValue * @beaninfo * preferred: true
*** 2025,2035 **** } /** * Returns the initial value. * ! * @return the <code>Object</code> that gets the initial keyboard focus * * @see #setInitialValue */ public Object getInitialValue() { return initialValue; --- 2025,2035 ---- } /** * Returns the initial value. * ! * @return the {@code Object} that gets the initial keyboard focus * * @see #setInitialValue */ public Object getInitialValue() { return initialValue;
*** 2037,2052 **** /** * Sets the option pane's message type. * The message type is used by the Look and Feel to determine the * icon to display (if not supplied) as well as potentially how to ! * lay out the <code>parentComponent</code>. * @param newType an integer specifying the kind of message to display: ! * <code>ERROR_MESSAGE</code>, <code>INFORMATION_MESSAGE</code>, ! * <code>WARNING_MESSAGE</code>, ! * <code>QUESTION_MESSAGE</code>, or <code>PLAIN_MESSAGE</code> ! * @exception RuntimeException if <code>newType</code> is not one of the * legal values listed above * @see #getMessageType * @beaninfo * preferred: true --- 2037,2052 ---- /** * Sets the option pane's message type. * The message type is used by the Look and Feel to determine the * icon to display (if not supplied) as well as potentially how to ! * lay out the {@code parentComponent}. * @param newType an integer specifying the kind of message to display: ! * {@code ERROR_MESSAGE}, {@code INFORMATION_MESSAGE}, ! * {@code WARNING_MESSAGE}, ! * {@code QUESTION_MESSAGE}, or {@code PLAIN_MESSAGE} ! * @exception RuntimeException if {@code newType} is not one of the * legal values listed above * @see #getMessageType * @beaninfo * preferred: true
*** 2086,2100 **** /** * Sets the options to display. * The option type is used by the Look and Feel to * determine what buttons to show (unless options are supplied). * @param newType an integer specifying the options the {@literal L&F} is to display: ! * <code>DEFAULT_OPTION</code>, ! * <code>YES_NO_OPTION</code>, ! * <code>YES_NO_CANCEL_OPTION</code>, ! * or <code>OK_CANCEL_OPTION</code> ! * @exception RuntimeException if <code>newType</code> is not one of * the legal values listed above * * @see #getOptionType * @see #setOptions * @beaninfo --- 2086,2100 ---- /** * Sets the options to display. * The option type is used by the Look and Feel to * determine what buttons to show (unless options are supplied). * @param newType an integer specifying the options the {@literal L&F} is to display: ! * {@code DEFAULT_OPTION}, ! * {@code YES_NO_OPTION}, ! * {@code YES_NO_CANCEL_OPTION}, ! * or {@code OK_CANCEL_OPTION} ! * @exception RuntimeException if {@code newType} is not one of * the legal values listed above * * @see #getOptionType * @see #setOptions * @beaninfo
*** 2132,2150 **** } /** * Sets the input selection values for a pane that provides the user * with a list of items to choose from. (The UI provides a widget ! * for choosing one of the values.) A <code>null</code> value * implies the user can input whatever they wish, usually by means ! * of a <code>JTextField</code>. * <p> ! * Sets <code>wantsInput</code> to true. Use ! * <code>setInitialSelectionValue</code> to specify the initially-chosen ! * value. After the pane as been enabled, <code>inputValue</code> is * set to the value the user has selected. ! * @param newValues an array of <code>Objects</code> the user to be * displayed * (usually in a list or combo-box) from which * the user can make a selection * @see #setWantsInput * @see #setInitialSelectionValue --- 2132,2150 ---- } /** * Sets the input selection values for a pane that provides the user * with a list of items to choose from. (The UI provides a widget ! * for choosing one of the values.) A {@code null} value * implies the user can input whatever they wish, usually by means ! * of a {@code JTextField}. * <p> ! * Sets {@code wantsInput} to true. Use ! * {@code setInitialSelectionValue} to specify the initially-chosen ! * value. After the pane as been enabled, {@code inputValue} is * set to the value the user has selected. ! * @param newValues an array of {@code Objects} the user to be * displayed * (usually in a list or combo-box) from which * the user can make a selection * @see #setWantsInput * @see #setInitialSelectionValue
*** 2163,2182 **** } /** * Returns the input selection values. * ! * @return the array of <code>Objects</code> the user can select * @see #setSelectionValues */ public Object[] getSelectionValues() { return selectionValues; } /** * Sets the input value that is initially displayed as selected to the user. ! * Only used if <code>wantsInput</code> is true. * @param newValue the initially selected value * @see #setSelectionValues * @see #getInitialSelectionValue * @beaninfo * bound: true --- 2163,2182 ---- } /** * Returns the input selection values. * ! * @return the array of {@code Objects} the user can select * @see #setSelectionValues */ public Object[] getSelectionValues() { return selectionValues; } /** * Sets the input value that is initially displayed as selected to the user. ! * Only used if {@code wantsInput} is true. * @param newValue the initially selected value * @see #setSelectionValues * @see #getInitialSelectionValue * @beaninfo * bound: true
*** 2201,2217 **** return initialSelectionValue; } /** * Sets the input value that was selected or input by the user. ! * Only used if <code>wantsInput</code> is true. Note that this method * is invoked internally by the option pane (in response to user action) * and should generally not be called by client programs. To set the * input value initially displayed as selected to the user, use ! * <code>setInitialSelectionValue</code>. * ! * @param newValue the <code>Object</code> used to set the * value that the user specified (usually in a text field) * @see #setSelectionValues * @see #setInitialSelectionValue * @see #setWantsInput * @see #getInputValue --- 2201,2217 ---- return initialSelectionValue; } /** * Sets the input value that was selected or input by the user. ! * Only used if {@code wantsInput} is true. Note that this method * is invoked internally by the option pane (in response to user action) * and should generally not be called by client programs. To set the * input value initially displayed as selected to the user, use ! * {@code setInitialSelectionValue}. * ! * @param newValue the {@code Object} used to set the * value that the user specified (usually in a text field) * @see #setSelectionValues * @see #setInitialSelectionValue * @see #setWantsInput * @see #getInputValue
*** 2226,2241 **** inputValue = newValue; firePropertyChange(INPUT_VALUE_PROPERTY, oldValue, newValue); } /** ! * Returns the value the user has input, if <code>wantsInput</code> * is true. * ! * @return the <code>Object</code> the user specified, * if it was one of the objects, or a ! * <code>String</code> if it was a value typed into a * field * @see #setSelectionValues * @see #setWantsInput * @see #setInputValue */ --- 2226,2241 ---- inputValue = newValue; firePropertyChange(INPUT_VALUE_PROPERTY, oldValue, newValue); } /** ! * Returns the value the user has input, if {@code wantsInput} * is true. * ! * @return the {@code Object} the user specified, * if it was one of the objects, or a ! * {@code String} if it was a value typed into a * field * @see #setSelectionValues * @see #setWantsInput * @see #setInputValue */
*** 2243,2269 **** return inputValue; } /** * Returns the maximum number of characters to place on a line in a ! * message. Default is to return <code>Integer.MAX_VALUE</code>. * The value can be * changed by overriding this method in a subclass. * * @return an integer giving the maximum number of characters on a line */ public int getMaxCharactersPerLineCount() { return Integer.MAX_VALUE; } /** ! * Sets the <code>wantsInput</code> property. ! * If <code>newValue</code> is true, an input component * (such as a text field or combo box) whose parent is ! * <code>parentComponent</code> is provided to ! * allow the user to input a value. If <code>getSelectionValues</code> ! * returns a non-<code>null</code> array, the input value is one of the * objects in that array. Otherwise the input value is whatever * the user inputs. * <p> * This is a bound property. * --- 2243,2269 ---- return inputValue; } /** * Returns the maximum number of characters to place on a line in a ! * message. Default is to return {@code Integer.MAX_VALUE}. * The value can be * changed by overriding this method in a subclass. * * @return an integer giving the maximum number of characters on a line */ public int getMaxCharactersPerLineCount() { return Integer.MAX_VALUE; } /** ! * Sets the {@code wantsInput} property. ! * If {@code newValue} is true, an input component * (such as a text field or combo box) whose parent is ! * {@code parentComponent} is provided to ! * allow the user to input a value. If {@code getSelectionValues} ! * returns a non-{@code null} array, the input value is one of the * objects in that array. Otherwise the input value is whatever * the user inputs. * <p> * This is a bound property. *
*** 2282,2292 **** wantsInput = newValue; firePropertyChange(WANTS_INPUT_PROPERTY, oldValue, newValue); } /** ! * Returns the value of the <code>wantsInput</code> property. * * @return true if an input component will be provided * @see #setWantsInput */ public boolean getWantsInput() { --- 2282,2292 ---- wantsInput = newValue; firePropertyChange(WANTS_INPUT_PROPERTY, oldValue, newValue); } /** ! * Returns the value of the {@code wantsInput} property. * * @return true if an input component will be provided * @see #setWantsInput */ public boolean getWantsInput() {
*** 2461,2478 **** } } /** ! * Returns a string representation of this <code>JOptionPane</code>. * This method * is intended to be used only for debugging purposes, and the * content and format of the returned string may vary between * implementations. The returned string may be empty but may not ! * be <code>null</code>. * ! * @return a string representation of this <code>JOptionPane</code> */ protected String paramString() { String iconString = (icon != null ? icon.toString() : ""); String initialValueString = (initialValue != null ? --- 2461,2478 ---- } } /** ! * Returns a string representation of this {@code JOptionPane}. * This method * is intended to be used only for debugging purposes, and the * content and format of the returned string may vary between * implementations. The returned string may be empty but may not ! * be {@code null}. * ! * @return a string representation of this {@code JOptionPane} */ protected String paramString() { String iconString = (icon != null ? icon.toString() : ""); String initialValueString = (initialValue != null ?
*** 2516,2529 **** /////////////////// // Accessibility support /////////////////// /** ! * Returns the <code>AccessibleContext</code> associated with this JOptionPane. ! * For option panes, the <code>AccessibleContext</code> takes the form of an ! * <code>AccessibleJOptionPane</code>. ! * A new <code>AccessibleJOptionPane</code> instance is created if necessary. * * @return an AccessibleJOptionPane that serves as the * AccessibleContext of this AccessibleJOptionPane * @beaninfo * expert: true --- 2516,2529 ---- /////////////////// // Accessibility support /////////////////// /** ! * Returns the {@code AccessibleContext} associated with this JOptionPane. ! * For option panes, the {@code AccessibleContext} takes the form of an ! * {@code AccessibleJOptionPane}. ! * A new {@code AccessibleJOptionPane} instance is created if necessary. * * @return an AccessibleJOptionPane that serves as the * AccessibleContext of this AccessibleJOptionPane * @beaninfo * expert: true
*** 2536,2556 **** return accessibleContext; } /** * This class implements accessibility support for the ! * <code>JOptionPane</code> class. It provides an implementation of the * Java Accessibility API appropriate to option pane user-interface * elements. * <p> * <strong>Warning:</strong> * Serialized objects of this class will not be compatible with * future Swing releases. The current serialization support is * appropriate for short term storage or RMI between applications running * the same version of Swing. As of 1.4, support for long term storage * of all JavaBeans&trade; ! * has been added to the <code>java.beans</code> package. * Please see {@link java.beans.XMLEncoder}. */ @SuppressWarnings("serial") // Same-version serialization only protected class AccessibleJOptionPane extends AccessibleJComponent { --- 2536,2556 ---- return accessibleContext; } /** * This class implements accessibility support for the ! * {@code JOptionPane} class. It provides an implementation of the * Java Accessibility API appropriate to option pane user-interface * elements. * <p> * <strong>Warning:</strong> * Serialized objects of this class will not be compatible with * future Swing releases. The current serialization support is * appropriate for short term storage or RMI between applications running * the same version of Swing. As of 1.4, support for long term storage * of all JavaBeans&trade; ! * has been added to the {@code java.beans} package. * Please see {@link java.beans.XMLEncoder}. */ @SuppressWarnings("serial") // Same-version serialization only protected class AccessibleJOptionPane extends AccessibleJComponent {
< prev index next >