Класс JOptionPane

javax.swing.JOptionPane

Все реализованные интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible

@JavaBean(defaultProperty="UI", description="A component which implements standard dialog box controls.") public class JOptionPane extends JComponent implements Accessible

JOptionPane упрощает создание стандартных диалоговых окон, которые запрашивают у пользователя значение или сообщают ему о чём-либо. Сведения о применении JOptionPane, см. в разделе Как создать диалоговые окна учебника по Java.

Несмотря на большое количество методов, класс JOptionPane в большинстве случаев используется в однострочных вызовах статических showXxxDialog методов, показанных ниже:

Общие имена методов JOptionPane и их описания
Имя метода	Описание
showConfirmDialog	Задает подтверждающий вопрос, например, да/нет/отмена.
showInputDialog	Запрашивает ввод данных.
showMessageDialog	Сообщает пользователю о произошедшем событии.
showOptionDialog	Объединяет три вышеперечисленных метода.

Каждый из этих методов также существует в showInternalXXX варианте, который использует внутреннюю рамку для размещения диалогового окна (см. JInternalFrame). Также определены несколько вспомогательных методов — перегруженные версии основных методов с различными списками параметров.

Все диалоговые окна являются модальными. Каждый метод showXxxDialog блокирует вызывающий метод, пока пользователь не завершит взаимодействие.

Общее диалоговое окно
иконка	сообщение
	значение ввода
кнопки выбора

Основной вид одного из этих диалоговых окон обычно похож на рисунок выше, хотя различные темы оформления в конечном итоге определяют окончательный результат. В частности, темы оформления изменят макет, чтобы учесть свойство ComponentOrientation панели опций.

Параметры:
Параметры этих методов следуют согласованным шаблонам:

parentComponent

Определяет Component , который должен быть родителем этого диалогового окна. Используется в двух способах: Frame , содержащий его, используется в качестве родителя диалогового окна, а его экранные координаты используются для размещения диалогового окна. Как правило, диалоговое окно размещается прямо под компонентом. Этот параметр может быть null, в этом случае используется значение по умолчанию Frame в качестве родителя, и диалоговое окно будет центрировано на экране (в зависимости от темы оформления).

message

Описательное сообщение, которое должно быть размещено в диалоговом окне. В большинстве случаев message — это просто String или String константа. Однако тип этого параметра фактически Object. Его интерпретация зависит от его типа:

Object[]

Массив объектов интерпретируется как ряд сообщений (по одному объекту) в вертикальной стопке. Интерпретация рекурсивна — каждый объект в массиве интерпретируется в соответствии со своим типом.

Component

Компонент отображается в диалоговом окне.

Icon

Иконка Icon обернута в JLabel и отображается в диалоговом окне.

others

Объект преобразуется в String с помощью метода toString. Результат обернут в JLabel и отображается.

messageType

Определяет стиль сообщения. Менеджер темы оформления может выложить диалоговое окно по-другому в зависимости от этого значения и часто предоставляет иконку по умолчанию. Возможные значения:

ERROR_MESSAGE

INFORMATION_MESSAGE

WARNING_MESSAGE

QUESTION_MESSAGE

PLAIN_MESSAGE

optionType

Определяет набор кнопок выбора, которые отображаются в нижней части диалогового окна:

DEFAULT_OPTION

YES_NO_OPTION

YES_NO_CANCEL_OPTION

OK_CANCEL_OPTION

Вы не ограничены этим набором кнопок. Вы можете указать любые кнопки, которые хотите, с помощью параметра options.

options

Более подробное описание набора кнопок выбора, которые будут отображаться в нижней части диалогового окна. Обычное значение для параметра options — массив String. Но тип параметра — массив Objects. Для каждого объекта создается кнопка в зависимости от его типа:

Component

Компонент добавляется непосредственно в строку кнопок.

Icon

Создается JButton с этим объектом в качестве метки.

other

Object преобразуется в строку с помощью метода toString , а результат используется в качестве метки JButton.

icon

Декоративная иконка, которая должна быть размещена в диалоговом окне. Значение по умолчанию определяется параметром messageType.

title

Заголовок диалогового окна.

initialValue

Значение по умолчанию (значение ввода).

При изменении выбора вызывается setValue , что генерирует PropertyChangeEvent.

Если JOptionPane настроен на все входные setWantsInput , связанное свойство JOptionPane.INPUT_VALUE_PROPERTY также может прослушиваться, чтобы определить, когда пользователь ввел или выбрал значение.

Когда один из методов showXxxDialog возвращает целое число, возможные значения:

YES_OPTION
NO_OPTION
CANCEL_OPTION
OK_OPTION
CLOSED_OPTION

Примеры:

Показать диалоговое окно об ошибке, отображающее сообщение «предупреждение»:


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

Показать внутреннее диалоговое окно с информацией с сообщением «информация»:

 JOptionPane.showInternalMessageDialog(frame, "information",
             "information", JOptionPane.INFORMATION_MESSAGE);

Показать панель с информацией с вариантами да/нет и сообщением «выберите один»:

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

Показать внутреннее диалоговое окно с информацией с вариантами да/нет/отмена и сообщением «пожалуйста, выберите один» и заголовком «информация»:

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

Показать диалоговое окно предупреждения с вариантами «ОК», «ОТМЕНА», заголовком «Предупреждение» и сообщением «Нажмите ОК для продолжения»:

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

Показать диалоговое окно, запрашивающее ввод строки:


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

Показать диалоговое окно, запрашивающее выбор строки:

 Object[] possibleValues = { "First", "Second", "Third" };

 Object selectedValue = JOptionPane.showInputDialog(null,
             "Choose one", "Input",
             JOptionPane.INFORMATION_MESSAGE, null,
             possibleValues, possibleValues[0]);

Прямое использование:
Чтобы напрямую создать и использовать JOptionPane , стандартный шаблон примерно следующий:

     JOptionPane pane = new JOptionPane(arguments);
     pane.set.Xxxx(...); // Configure
     JDialog dialog = pane.createDialog(parentComponent, title);
     dialog.show();
     Object selectedValue = pane.getValue();
     if(selectedValue == null)
       return CLOSED_OPTION;
     //If there is not an array of option buttons:
     if(options == null) {
       if(selectedValue instanceof Integer)
          return ((Integer)selectedValue).intValue();
       return CLOSED_OPTION;
     }
     //If there is an array of option buttons:
     for(int counter = 0, maxCounter = options.length;
        counter < maxCounter; counter++) {
        if(options[counter].equals(selectedValue))
        return counter;
     }
     return CLOSED_OPTION;

Предупреждение: Swing не является потокобезопасным. Дополнительную информацию см. в разделе Политика потоков Swing.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, добавлена поддержка долговременного хранения всех JavaBeans в пакет java.beans. См. XMLEncoder.

Since:

1.2

См. также:

JInternalFrame

Краткое описание вложенных классов

Modifier and Type	Class	Description
`protected class`	`JOptionPane.AccessibleJOptionPane`	Этот класс реализует поддержку доступности для класса `JOptionPane`.

Вложенные классы/интерфейсы, объявленные в классе javax.swing.JComponent

JComponent.AccessibleJComponent

Вложенные классы/интерфейсы, объявленные в классе java.awt.Container

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Краткое описание полей

Modifier and Type	Field	Description
`static final int`	`CANCEL_OPTION`	Возвращаемое значение метода класса, если выбран CANCEL.
`static final int`	`CLOSED_OPTION`	Возвращаемое значение метода класса, если пользователь закрывает окно, не выбрав ничего; в большинстве случаев это следует рассматривать как либо `CANCEL_OPTION`, либо `NO_OPTION`.
`static final int`	`DEFAULT_OPTION`	Тип, означающий, что виджет не должен предоставлять никаких опций — следует использовать только опции из `JOptionPane`.
`static final int`	`ERROR_MESSAGE`	Используется для сообщений об ошибках.
`protected Icon`	`icon`	Иконка, используемая в панели.
`static final String`	`ICON_PROPERTY`	Имя привязанного свойства для `icon`.
`static final int`	`INFORMATION_MESSAGE`	Используется для информационных сообщений.
`static final String`	`INITIAL_SELECTION_VALUE_PROPERTY`	Имя привязанного свойства для `initialSelectionValue`.
`static final String`	`INITIAL_VALUE_PROPERTY`	Имя привязанного свойства для `initialValue`.
`protected Object`	`initialSelectionValue`	Начальное значение для выбора в `selectionValues`.
`protected Object`	`initialValue`	Значение, которое должно быть изначально выбрано в `options`.
`static final String`	`INPUT_VALUE_PROPERTY`	Имя привязанного свойства для `inputValue`.
`protected Object`	`inputValue`	Введенное пользователем значение.
`protected Object`	`message`	Сообщение для отображения.
`static final String`	`MESSAGE_PROPERTY`	Имя привязанного свойства для `message`.
`static final String`	`MESSAGE_TYPE_PROPERTY`	Имя привязанного свойства для `type`.
`protected int`	`messageType`	Тип сообщения.
`static final int`	`NO_OPTION`	Возвращаемое значение метода класса, если выбран NO.
`static final int`	`OK_CANCEL_OPTION`	Тип, используемый для `showConfirmDialog`.
`static final int`	`OK_OPTION`	Возвращаемое значение метода класса, если выбран OK.
`static final String`	`OPTION_TYPE_PROPERTY`	Имя привязанного свойства для `optionType`.
`protected Object[]`	`options`	Опции для отображения пользователю.
`static final String`	`OPTIONS_PROPERTY`	Имя привязанного свойства для `option`.
`protected int`	`optionType`	Тип опции, один из `DEFAULT_OPTION`, `YES_NO_OPTION`, `YES_NO_CANCEL_OPTION` или `OK_CANCEL_OPTION`.
`static final int`	`PLAIN_MESSAGE`	Иконка не используется.
`static final int`	`QUESTION_MESSAGE`	Используется для вопросов.
`static final String`	`SELECTION_VALUES_PROPERTY`	Имя привязанного свойства для `selectionValues`.
`protected Object[]`	`selectionValues`	Массив значений, из которых пользователь может выбрать.
`static final Object`	`UNINITIALIZED_VALUE`	Указывает, что пользователь еще не выбрал значение.
`protected Object`	`value`	Текущее выбранное значение, будет являться допустимой опцией, или `UNINITIALIZED_VALUE` или `null`.
`static final String`	`VALUE_PROPERTY`	Имя привязанного свойства для `value`.
`static final String`	`WANTS_INPUT_PROPERTY`	Имя привязанного свойства для `wantsInput`.
`protected boolean`	`wantsInput`	Если true, пользователю будет предоставлен виджет для ввода.
`static final int`	`WARNING_MESSAGE`	Используется для предупреждающих сообщений.
`static final int`	`YES_NO_CANCEL_OPTION`	Тип, используемый для `showConfirmDialog`.
`static final int`	`YES_NO_OPTION`	Тип, используемый для `showConfirmDialog`.
`static final int`	`YES_OPTION`	Возвращаемое значение метода класса, если выбран YES.

Поля, объявленные в классе javax.swing.JComponent

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

Поля, объявленные в классе java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе java.awt.image.ImageObserver

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

Краткое описание конструкторов

Конструктор	Description
`JOptionPane()`	Создаёт `JOptionPane` с тестовым сообщением.
`JOptionPane(Object message)`	Создаёт экземпляр `JOptionPane` для отображения сообщения с типом сообщения plain-message и стандартными опциями, предоставляемыми UI.
`JOptionPane(Object message, int messageType)`	Создаёт экземпляр `JOptionPane` для отображения сообщения со специфическим типом сообщения и стандартными опциями.
`JOptionPane(Object message, int messageType, int optionType)`	Создаёт экземпляр `JOptionPane` для отображения сообщения со специфическим типом сообщения и опциями.
`JOptionPane(Object message, int messageType, int optionType, Icon icon)`	Создаёт экземпляр `JOptionPane` для отображения сообщения со специфическим типом сообщения, иконкой.
`JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options)`	Создаёт экземпляр `JOptionPane` для отображения сообщения со специфическим типом сообщения, иконкой и опциями.
`JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options, Object initialValue)`	Создаёт экземпляр `JOptionPane` для отображения сообщения со специфическим типом сообщения, иконкой, опциями и заданным изначально выбранной опцией.

Краткое описание методов

Модификатор и тип	Метод	Описание
`JDialog`	`createDialog(Component parentComponent, String title)`	Создаёт и возвращает новый `JDialog`, содержащий `this`, центрированный на `parentComponent` в рамках `parentComponent`.
`JDialog`	`createDialog(String title)`	Создаёт и возвращает новый `JDialog` без родителя со заданным заголовком.
`JInternalFrame`	`createInternalFrame(Component parentComponent, String title)`	Создаёт и возвращает экземпляр `JInternalFrame`.
`AccessibleContext`	`getAccessibleContext()`	Возвращает `AccessibleContext` ассоциированное с этим JOptionPane.
`static JDesktopPane`	`getDesktopPaneForComponent(Component parentComponent)`	Возвращает рабочий стол, связанный с указанным компонентом.
`static Frame`	`getFrameForComponent(Component parentComponent)`	Возвращает `Frame` указанного компонента.
`Icon`	`getIcon()`	Возвращает значок, отображаемый в этой панели.
`Object`	`getInitialSelectionValue()`	Возвращает значение ввода, которое отображается как изначально выбранное для пользователя.
`Object`	`getInitialValue()`	Возвращает начальное значение.
`Object`	`getInputValue()`	Возвращает значение, введённое пользователем, если `wantsInput` имеет значение true.
`int`	`getMaxCharactersPerLineCount()`	Возвращает максимальное количество символов на строке в сообщении.
`Object`	`getMessage()`	Возвращает объект сообщения, отображаемый в этой панели.
`int`	`getMessageType()`	Возвращает тип сообщения.
`Object[]`	`getOptions()`	Возвращает варианты, которые пользователь может выбрать.
`int`	`getOptionType()`	Возвращает тип отображаемых опций.
`static Frame`	`getRootFrame()`	Возвращает `Frame` для использования методами класса, когда фрейм не предоставляется.
`Object[]`	`getSelectionValues()`	Возвращает значения выбранного ввода.
`OptionPaneUI`	`getUI()`	Возвращает объект пользовательского интерфейса, реализующий L&F для этого компонента.
`String`	`getUIClassID()`	Возвращает имя класса пользовательского интерфейса, реализующего L&F для этого компонента.
`Object`	`getValue()`	Возвращает значение, выбранное пользователем.
`boolean`	`getWantsInput()`	Возвращает значение свойства `wantsInput`.
`protected String`	`paramString()`	Возвращает строковое представление этого `JOptionPane`.
`void`	`selectInitialValue()`	Запрашивает выбор начального значения, что установит фокус на начальное значение.
`void`	`setIcon(Icon newIcon)`	Устанавливает значок для отображения.
`void`	`setInitialSelectionValue(Object newValue)`	Устанавливает значение ввода, которое изначально отображается как выбранное для пользователя.
`void`	`setInitialValue(Object newInitialValue)`	Устанавливает начальное значение, которое должно быть включено — `Component`, у которого есть фокус, когда панель изначально отображается.
`void`	`setInputValue(Object newValue)`	Устанавливает значение ввода, которое было выбрано или введено пользователем.
`void`	`setMessage(Object newMessage)`	Устанавливает объект сообщения опциональной панели.
`void`	`setMessageType(int newType)`	Устанавливает тип сообщения опциональной панели.
`void`	`setOptions(Object[] newOptions)`	Устанавливает опции, отображаемые в этой панели.
`void`	`setOptionType(int newType)`	Устанавливает опции для отображения.
`static void`	`setRootFrame(Frame newRootFrame)`	Устанавливает фрейм для использования методами класса, в которых фрейм не указан.
`void`	`setSelectionValues(Object[] newValues)`	Устанавливает значения выбора ввода для панели, которая предоставляет пользователю список элементов для выбора.
`void`	`setUI(OptionPaneUI ui)`	Устанавливает объект пользовательского интерфейса, реализующий L&F для этого компонента.
`void`	`setValue(Object newValue)`	Устанавливает значение, выбранное пользователем.
`void`	`setWantsInput(boolean newValue)`	Устанавливает свойство `wantsInput`.
`static int`	`showConfirmDialog(Component parentComponent, Object message)`	Открывает диалог с опциями Да, Нет и Отмена; с заголовком Выберите опцию.
`static int`	`showConfirmDialog(Component parentComponent, Object message, String title, int optionType)`	Открывает диалог, где количество вариантов определяется параметром `optionType`.
`static int`	`showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)`	Открывает диалог, где количество вариантов определяется параметром `optionType`, а параметр `messageType` определяет значок для отображения.
`static int`	`showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon)`	Открывает диалог со указанным значком, где количество вариантов определяется параметром `optionType`.
`static String`	`showInputDialog(Component parentComponent, Object message)`	Отображает диалог вопроса с запросом ввода от пользователя, родительским элементом для которого является `parentComponent`.
`static String`	`showInputDialog(Component parentComponent, Object message, Object initialSelectionValue)`	Отображает диалог вопроса с запросом ввода от пользователя, родительским элементом для которого является `parentComponent`.
`static String`	`showInputDialog(Component parentComponent, Object message, String title, int messageType)`	Отображает диалог с запросом ввода от пользователя, родительским элементом для которого является `parentComponent`, с заголовком `title` и типом сообщения `messageType`.
`static Object`	`showInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue)`	Запрашивает ввод у пользователя в блокирующем диалоговом окне, где можно указать начальный выбор, возможные варианты и все остальные параметры.
`static String`	`showInputDialog(Object message)`	Отображает диалог вопроса с запросом ввода от пользователя.
`static String`	`showInputDialog(Object message, Object initialSelectionValue)`	Отображает диалог вопроса с запросом ввода от пользователя, с значением ввода, инициализированным значением `initialSelectionValue`.
`static int`	`showInternalConfirmDialog(Component parentComponent, Object message)`	Открывает внутреннюю диалоговую панель с опциями Да, Нет и Отмена; с заголовком Выберите опцию.
`static int`	`showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType)`	Открывает внутреннюю диалоговую панель, где количество вариантов определяется параметром `optionType`.
`static int`	`showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)`	Открывает внутреннюю диалоговую панель, где количество вариантов определяется параметром `optionType`, а параметр `messageType` определяет значок для отображения.
`static int`	`showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon)`	Открывает внутреннюю диалоговую панель со указанным значком, где количество вариантов определяется параметром `optionType`.
`static String`	`showInternalInputDialog(Component parentComponent, Object message)`	Отображает внутренний диалог вопроса с запросом ввода от пользователя, родительским элементом для которого является `parentComponent`.
`static String`	`showInternalInputDialog(Component parentComponent, Object message, String title, int messageType)`	Отображает внутренний диалог с запросом ввода от пользователя, родительским элементом для которого является `parentComponent`, с заголовком `title` и типом сообщения `messageType`.
`static Object`	`showInternalInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue)`	Запрашивает ввод у пользователя во внутреннем блокирующем диалоговом окне, где можно указать начальный выбор, возможные варианты и все остальные параметры.
`static void`	`showInternalMessageDialog(Component parentComponent, Object message)`	Открывает внутреннюю диалоговую панель подтверждения.
`static void`	`showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType)`	Открывает внутреннюю диалоговую панель, отображающую сообщение с помощью значка по умолчанию, определяемого параметром `messageType`.
`static void`	`showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon)`	Открывает внутреннюю диалоговую панель, отображающую сообщение, указав все параметры.

`static int`	`showInternalOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue)`	Выводит внутренний диалоговый подпанель с указанным иконкой, где начальный выбор определяется параметром `initialValue`, а количество вариантов определяется параметром `optionType`.
`static void`	`showMessageDialog(Component parentComponent, Object message)`	Выводит диалоговое окно с информационным сообщением с заголовком "Сообщение".
`static void`	`showMessageDialog(Component parentComponent, Object message, String title, int messageType)`	Выводит диалоговое окно, отображающее сообщение с использованием значка по умолчанию, определяемого параметром `messageType`.
`static void`	`showMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon)`	Выводит диалоговое окно, отображающее сообщение, при этом указываются все параметры.
`static int`	`showOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue)`	Выводит диалоговое окно с указанной иконкой, где начальный выбор определяется параметром `initialValue`, а количество вариантов — параметром `optionType`.
`void`	`updateUI()`	Уведомление от `UIManager` о том, что внешний вид (L&F) изменён.

Методы, объявленные в классе javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Методы, объявленные в классе java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Методы, объявленные в классе java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе java.lang.Object

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

Подробное описание полей

UNINITIALIZED_VALUE

public static final Object UNINITIALIZED_VALUE

Указывает, что пользователь ещё не выбрал значение.

DEFAULT_OPTION

public static final int DEFAULT_OPTION

Тип, означающий, что виджет Look and Feel не должен предоставлять никаких вариантов — следует использовать только варианты из JOptionPane.

См. также:

Значения константных полей

YES_NO_OPTION

public static final int YES_NO_OPTION

Тип, используемый для showConfirmDialog.

См. также:

Значения константных полей

YES_NO_CANCEL_OPTION

public static final int YES_NO_CANCEL_OPTION

Тип, используемый для showConfirmDialog.

См. также:

Значения константных полей

OK_CANCEL_OPTION

public static final int OK_CANCEL_OPTION

Тип, используемый для showConfirmDialog.

См. также:

Значения константных полей

YES_OPTION

public static final int YES_OPTION

Возвращаемое значение метода класса, если выбран «ДА».

См. также:

Значения константных полей

NO_OPTION

public static final int NO_OPTION

Возвращаемое значение метода класса, если выбран «НЕТ».

См. также:

Значения константных полей

CANCEL_OPTION

public static final int CANCEL_OPTION

Возвращаемое значение метода класса, если выбран «ОТМЕНА».

См. также:

Значения константных полей

OK_OPTION

public static final int OK_OPTION

Возвращаемое значение метода класса, если выбран «ОК».

См. также:

Значения константных полей

CLOSED_OPTION

public static final int CLOSED_OPTION

Возвращаемое значение метода класса, если пользователь закрывает окно, ничего не выбрав. В большинстве случаев это следует рассматривать как либо CANCEL_OPTION либо NO_OPTION.

См. также:

Значения константных полей

ERROR_MESSAGE

public static final int ERROR_MESSAGE

Используется для сообщений об ошибках.

См. также:

Значения константных полей

INFORMATION_MESSAGE

public static final int INFORMATION_MESSAGE

Используется для информационных сообщений.

См. также:

Значения константных полей

WARNING_MESSAGE

public static final int WARNING_MESSAGE

Используется для сообщений об ошибках.

См. также:

Значения константных полей

QUESTION_MESSAGE

public static final int QUESTION_MESSAGE

Используется для вопросов.

См. также:

Значения константных полей

PLAIN_MESSAGE

public static final int PLAIN_MESSAGE

Иконка не используется.

См. также:

Значения константных полей

СВОЙСТВО_ИКОНКИ

public static final String ICON_PROPERTY

Имя связанного свойства для icon.

См. также:

Значения константных полей

СВОЙСТВО_СООБЩЕНИЯ

public static final String MESSAGE_PROPERTY

Имя связанного свойства для message.

См. также:

Значения константных полей

СВОЙСТВО_ЗНАЧЕНИЯ

public static final String VALUE_PROPERTY

Имя связанного свойства для value.

См. также:

Значения константных полей

СВОЙСТВО_ВАРИАНТОВ

public static final String OPTIONS_PROPERTY

Имя связанного свойства для option.

См. также:

Значения константных полей

СВОЙСТВО_НАЧАЛЬНОГО_ЗНАЧЕНИЯ

public static final String INITIAL_VALUE_PROPERTY

Имя связанного свойства для initialValue.

См. также:

Значения константных полей

СВОЙСТВО_ТИПА_СООБЩЕНИЯ

public static final String MESSAGE_TYPE_PROPERTY

Имя связанного свойства для type.

См. также:

Значения константных полей

СВОЙСТВО_ТИПА_ВАРИАНТА

public static final String OPTION_TYPE_PROPERTY

Имя связанного свойства для optionType.

См. также:

Значения константных полей

СВОЙСТВО_ЗНАЧЕНИЙ_ВЫБОРА

public static final String SELECTION_VALUES_PROPERTY

Имя связанного свойства для selectionValues.

См. также:

Значения константных полей

СВОЙСТВО_НАЧАЛЬНОГО_ЗНАЧЕНИЯ_ВЫБОРА

public static final String INITIAL_SELECTION_VALUE_PROPERTY

Имя связанного свойства для initialSelectionValue.

См. также:

Значения константных полей

СВОЙСТВО_ЗНАЧЕНИЯ_ВВОДА

public static final String INPUT_VALUE_PROPERTY

Имя связанного свойства для inputValue.

См. также:

Значения константных полей

СВОЙСТВО_ТРЕБУЕТ_ВВОДА

public static final String WANTS_INPUT_PROPERTY

Имя связанного свойства для wantsInput.

См. также:

Значения константных полей

иконка

protected transient Icon icon

Иконка, используемая в панели.

сообщение

protected transient Object message

Сообщение для отображения.

варианты

protected transient Object[] options

Варианты, отображаемые пользователю.

начальноеЗначение

protected transient Object initialValue

Значение, которое должно быть выбрано в options.

типСообщения

protected int messageType

Тип сообщения.

Тип опции

protected int optionType

Тип опции, один из DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION или OK_CANCEL_OPTION.

значение

protected transient Object value

Текущее выбранное значение, будет являться действительной опцией, или UNINITIALIZED_VALUE или null.

selectionValues

protected transient Object[] selectionValues

Массив значений, из которых пользователь может выбрать. Визуальный интерфейс предоставит компонент для выбора.

inputValue

protected transient Object inputValue

Значение, введенное пользователем.

initialSelectionValue

protected transient Object initialSelectionValue

Начальное значение для выбора в selectionValues.

wantsInput

protected boolean wantsInput

Если true, пользователю будет предоставлен виджет пользовательского ввода.

Подробное описание конструкторов

JOptionPane

public JOptionPane()

Создаёт JOptionPane с тестовым сообщением.

JOptionPane

public JOptionPane(Object message)

Создаёт экземпляр JOptionPane для отображения сообщения с типом простого сообщения и стандартными опциями, предоставляемыми пользовательским интерфейсом.

Параметры:: message - отображаемое Object

JOptionPane

public JOptionPane(Object message, int messageType)

Создаёт экземпляр JOptionPane для отображения сообщения с указанным типом сообщения и стандартными опциями.

Параметры:: message - отображаемое Object; messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE

JOptionPane

public JOptionPane(Object message, int messageType, int optionType)

Создаёт экземпляр JOptionPane для отображения сообщения с указанным типом сообщения и опциями.

Параметры:: message - отображаемое Object; messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE; optionType - опции для отображения в панели: DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION, OK_CANCEL_OPTION

JOptionPane

public JOptionPane(Object message, int messageType, int optionType, Icon icon)

Создаёт экземпляр JOptionPane для отображения сообщения с указанным типом сообщения, опциями и иконкой.

Параметры:: message - отображаемое Object; messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE; optionType - опции для отображения в панели: DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION, OK_CANCEL_OPTION; icon - отображаемое Icon изображение

JOptionPane

public JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options)

Создаёт экземпляр JOptionPane для отображения сообщения с указанным типом сообщения, иконкой и опциями. Ни одна из опций не выбрана изначально.

Объекты опций должны содержать экземпляры Component (которые добавляются напрямую) или Strings (которые оборачиваются в JButton). Если вы предоставляете Component, вы должны убедиться, что при нажатии на Component в созданном JOptionPane отправляется сообщение setValue.

Параметры:: message - отображаемое Object; messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE; optionType - опции для отображения в панели: DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION, OK_CANCEL_OPTION; icon - отображаемое Icon изображение; options - варианты, которые пользователь может выбрать

JOptionPane

public JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options, Object initialValue)

Создаёт экземпляр JOptionPane для отображения сообщения с указанным типом сообщения, иконкой и опциями, с указанием изначально выбранной опции.

Параметры:: message - отображаемое Object; messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE; optionType - опции для отображения в панели: DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION, OK_CANCEL_OPTION; icon - изображение-иконка; options - варианты, которые пользователь может выбрать; initialValue - выбранный изначально вариант; если null, то ничего не будет выбрано изначально; имеет смысл только если используется options

Подробное описание методов

showInputDialog

public static String showInputDialog(Object message) throws HeadlessException

Отображает диалоговое окно с сообщением вопроса, запрашивающее ввод от пользователя. Диалоговое окно использует стандартную рамку, что обычно означает его центрирование на экране.

Параметры:

message - отображаемое Object

Возвращает:

ввод пользователя

Исключение:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

См. также:

GraphicsEnvironment.isHeadless()

showInputDialog

public static String showInputDialog(Object message, Object initialSelectionValue)

Отображает диалоговое окно с сообщением вопроса, запрашивающее ввод от пользователя, с предварительно заданным значением ввода initialSelectionValue. Диалоговое окно использует стандартную рамку, что обычно означает его центрирование на экране.

Параметры:: message - отображаемое Object; initialSelectionValue - значение, используемое для инициализации поля ввода
Возвращает:: ввод пользователя
С момента:: 1.4

showInputDialog

public static String showInputDialog(Component parentComponent, Object message) throws HeadlessException

Отображает диалоговое окно с сообщением вопроса, запрашивающее ввод от пользователя, привязанное к parentComponent. Диалоговое окно отображается поверх фрейма Component, и обычно располагается под Component.

Параметры:

parentComponent - родительский Component для диалогового окна

message - отображаемое Object

Возвращает:

ввод пользователя

Исключение:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

См. также:

GraphicsEnvironment.isHeadless()

showInputDialog

public static String showInputDialog(Component parentComponent, Object message, Object initialSelectionValue)

Отображает диалоговое окно с сообщением вопроса, запрашивающее ввод от пользователя, привязанное к parentComponent. Значение ввода будет инициализировано значением initialSelectionValue. Диалоговое окно отображается поверх фрейма Component, и обычно располагается под Component.

Параметры:: parentComponent - родительский Component для диалогового окна; message - отображаемое Object; initialSelectionValue - значение, используемое для инициализации поля ввода
Возвращает:: ввод пользователя
С момента:: 1.4

showInputDialog

public static String showInputDialog(Component parentComponent, Object message, String title, int messageType) throws HeadlessException

Отображает диалоговое окно, запрашивающее ввод от пользователя, привязанное к parentComponent, с заголовком title и типом сообщения messageType.

Параметры:

parentComponent - родительский Component для диалогового окна

message - отображаемое Object

title - заголовок, отображаемый в строке заголовка диалогового окна

messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE

Возвращает:

ввод пользователя

Исключение:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

См. также:

GraphicsEnvironment.isHeadless()

showInputDialog

public static Object showInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue) throws HeadlessException

Запрашивает у пользователя ввод данных в блокирующем диалоговом окне, где можно указать начальный выбор, возможные варианты и другие параметры. Пользователь сможет выбрать из selectionValues, где null подразумевает, что пользователь может ввести любое значение, обычно с помощью JTextField. initialSelectionValue — начальное значение, с которым отображается приглашение пользователю. Визуальное представление selectionValues зависит от интерфейса пользователя, но обычно используется JComboBox, JList, или JTextField.

Parameters:

parentComponent - родительское Component для диалогового окна

message - отображаемое Object

title - отображаемая String в строке заголовка диалогового окна

messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE

icon - отображаемое Icon изображение

selectionValues - массив Object вариантов выбора

initialSelectionValue - значение для инициализации поля ввода

Returns:

введенные пользователем данные или null , если пользователь отменил ввод

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

See Also:

GraphicsEnvironment.isHeadless()

showMessageDialog

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

Отображает диалоговое окно с информацией, заголовок которого "Сообщение".

Parameters:

parentComponent - определяет Frame отображения диалогового окна; если null, или если у parentComponent нет Frame, используется значение по умолчанию Frame

message - отображаемое Object

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

See Also:

GraphicsEnvironment.isHeadless()

showMessageDialog

public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType) throws HeadlessException

Отображает диалоговое окно с сообщением, используя значок по умолчанию, определяемый параметром messageType.

Parameters:

message - отображаемое Object

title - строка заголовка диалогового окна

messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

See Also:

GraphicsEnvironment.isHeadless()

showMessageDialog

public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon) throws HeadlessException

Отображает диалоговое окно с сообщением, задавая все параметры.

Parameters:

message - отображаемое Object

title - строка заголовка диалогового окна

messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE

icon - значок, отображаемый в диалоговом окне, помогающий пользователю определить тип сообщения

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

See Also:

GraphicsEnvironment.isHeadless()

showConfirmDialog

public static int showConfirmDialog(Component parentComponent, Object message) throws HeadlessException

Отображает диалоговое окно с вариантами Да, Нет и Отмена; с заголовком Выберите вариант.

Parameters:

message - отображаемое Object

Returns:

целое число, указывающее выбранный пользователем вариант

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

See Also:

GraphicsEnvironment.isHeadless()

showConfirmDialog

public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType) throws HeadlessException

Отображает диалоговое окно, количество вариантов которого определяется параметром optionType.

Parameters:

message - отображаемое Object

title - строка заголовка диалогового окна

optionType - целое число, определяющее доступные варианты в диалоговом окне: YES_NO_OPTION, YES_NO_CANCEL_OPTION, или OK_CANCEL_OPTION

Returns:

целое число, указывающее выбранный пользователем вариант

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

See Also:

GraphicsEnvironment.isHeadless()

showConfirmDialog

public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType) throws HeadlessException

Отображает диалоговое окно, количество вариантов которого определяется параметром optionType, а параметр messageType определяет отображаемый значок. Параметр messageType используется в основном для задания значка по умолчанию из темы оформления.

Parameters:

parentComponent - определяет Frame отображения диалогового окна; если null, или если у parentComponent нет Frame, используется значение по умолчанию Frame.

message - отображаемый Object

title - строка заголовка диалогового окна

optionType - целое число, определяющее доступные варианты в диалоговом окне: YES_NO_OPTION, YES_NO_CANCEL_OPTION, или OK_CANCEL_OPTION

messageType - целое число, определяющее тип сообщения, используется в основном для определения значка из темы оформления: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE

Returns:

целое число, указывающее выбранный пользователем вариант

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

See Also:

GraphicsEnvironment.isHeadless()

showConfirmDialog

public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon) throws HeadlessException

Отображает диалоговое окно с указанным значком, количество вариантов которого определяется параметром optionType. Параметр messageType используется в основном для задания значка по умолчанию из темы оформления.

Parameters:

message - отображаемый объект

title - строка заголовка диалогового окна

optionType - целое число, определяющее доступные варианты в диалоговом окне: YES_NO_OPTION, YES_NO_CANCEL_OPTION, или OK_CANCEL_OPTION

icon - значок, отображаемый в диалоговом окне

Returns:

целое число, указывающее выбранный пользователем вариант

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

See Also:

GraphicsEnvironment.isHeadless()

showOptionDialog

public static int showOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue) throws HeadlessException

Выводит диалоговое окно со специфицированным значком, где начальный выбор определяется параметром initialValue, а количество вариантов определяется параметром optionType.

Если optionType равен YES_NO_OPTION, или YES_NO_CANCEL_OPTION, и параметр options равен null, тогда варианты предоставляются внешним видом.

Параметр messageType в основном используется для предоставления значка по умолчанию из внешнего вида.

Параметры:

parentComponent - определяет Frame, в котором отображается диалоговое окно; если null, или если у parentComponent нет Frame, используется значение по умолчанию Frame

message - отображаемый Object

title - строка заголовка диалогового окна

optionType - целое число, обозначающее доступные варианты в диалоговом окне: DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION, или OK_CANCEL_OPTION

messageType - целое число, обозначающее тип сообщения, в основном используется для определения значка из подключаемого внешнего вида: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE

icon - значок для отображения в диалоговом окне

options - массив объектов, указывающий возможные варианты выбора пользователем; если объекты являются компонентами, они отображаются должным образом; не-String объекты отображаются с помощью их методов toString; если этот параметр равен null, варианты определяются внешним видом

initialValue - объект, представляющий значение по умолчанию для диалогового окна; имеет смысл только если используется options; может быть null

Возвращаемое значение:

целое число, указывающее выбранный пользователем вариант, или CLOSED_OPTION, если пользователь закрыл диалоговое окно

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

См. также:

GraphicsEnvironment.isHeadless()

createDialog

public JDialog createDialog(Component parentComponent, String title) throws HeadlessException

Создает и возвращает новый JDialog контейнер, содержащий this, центрированный на parentComponent в рамке parentComponent. title — заголовок возвращаемого диалогового окна. Возвращаемое диалоговое окно не будет изменяться пользователем, однако программы могут вызвать setResizable на экземпляре JDialog, чтобы изменить это свойство. Возвращаемое диалоговое окно будет настроено таким образом, что после закрытия или нажатия пользователем на одну из кнопок, свойство значения optionpane будет установлено соответствующим образом, и диалоговое окно закроется. Каждый раз при отображении диалогового окна оно будет сбрасывать свойство значения option pane до JOptionPane.UNINITIALIZED_VALUE, чтобы гарантировать, что последующее действие пользователя закроет диалоговое окно должным образом.

Параметры:

parentComponent - определяет рамку, в которой отображается диалоговое окно; если у parentComponent нет Frame, используется значение по умолчанию Frame

title - строка заголовка диалогового окна

Возвращаемое значение:

новый JDialog контейнер, содержащий этот экземпляр

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

См. также:

GraphicsEnvironment.isHeadless()

createDialog

public JDialog createDialog(String title) throws HeadlessException

Создает и возвращает новое JDialog без родителя со указанным заголовком. Возвращаемое JDialog не будет изменяться пользователем, но программы могут вызвать setResizable на экземпляре JDialog, чтобы изменить это свойство. Возвращаемое JDialog будет настроено таким образом, что после закрытия или нажатия пользователем на одну из кнопок, свойство значения optionpane будет установлено соответствующим образом, и диалоговое окно закроется. Каждый раз при отображении диалогового окна оно будет сбрасывать свойство значения option pane до JOptionPane.UNINITIALIZED_VALUE, чтобы гарантировать корректное закрытие диалогового окна при последующем действии пользователя.

Параметры:

title - строка заголовка диалогового окна

Возвращаемое значение:

новый JDialog контейнер, содержащий этот экземпляр

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

С:

1.6

См. также:

GraphicsEnvironment.isHeadless()

showInternalMessageDialog

public static void showInternalMessageDialog(Component parentComponent, Object message)

Выводит внутреннее диалоговое окно подтверждения. Диалоговое окно — это диалоговое окно с информационным сообщением и заголовком "Сообщение".

Параметры:: parentComponent - определяет Frame, в котором отображается диалоговое окно; если null, или если у parentComponent нет Frame, используется значение по умолчанию Frame; message - отображаемый объект

showInternalMessageDialog

public static void showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType)

Выводит внутреннее диалоговое окно, отображающее сообщение с использованием значка по умолчанию, определяемого параметром messageType

Параметры:: parentComponent - определяет Frame, в котором отображается диалоговое окно; если null, или если у parentComponent нет Frame, используется значение по умолчанию Frame; message - отображаемое Object; title - строка заголовка диалогового окна; messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE

showInternalMessageDialog

public static void showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon)

Выводит внутреннее диалоговое окно, отображающее сообщение со всеми параметрами.

Параметры:: parentComponent - определяет Frame, в котором отображается диалоговое окно; если null, или если у parentComponent нет Frame, используется значение по умолчанию Frame; message - отображаемое Object; title - строка заголовка диалогового окна; messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE; icon - значок для отображения в диалоговом окне, помогающий пользователю определить тип отображаемого сообщения

showInternalConfirmDialog

public static int showInternalConfirmDialog(Component parentComponent, Object message)

Выводит внутреннее диалоговое окно с опциями Да, Нет и Отмена; с заголовком Выберите вариант.

Параметры:: parentComponent - определяет Frame, в котором отображается диалоговое окно; если null, или если у parentComponent нет Frame, используется значение по умолчанию Frame; message - отображаемый Object
Возвращаемое значение:: целое число, обозначающее выбранный пользователем вариант

showInternalConfirmDialog

public static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType)

Выводит внутреннее диалоговое окно, где количество вариантов определяется параметром optionType

Параметры:: parentComponent - определяет Frame, в котором отображается диалоговое окно; если null, или если у parentComponent нет Frame, используется значение по умолчанию Frame; message - отображаемый в диалоговом окне объект; объект Component отображается как Component; объект String отображается как строка; другие объекты преобразуются в строку с помощью метода String, используя метод toString; title - строка заголовка диалогового окна; optionType - целое число, обозначающее доступные варианты в диалоговом окне: YES_NO_OPTION, или YES_NO_CANCEL_OPTION
Возвращаемое значение:: целое число, обозначающее выбранный пользователем вариант

showInternalConfirmDialog

public static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)

Выводит внутренний диалоговый панельный элемент, где количество вариантов определяется параметром optionType, а параметр messageType определяет отображаемый значок. Параметр messageType в основном используется для предоставления значка по умолчанию из темы оформления.

Parameters:: parentComponent - определяет Frame, в котором отображается диалоговое окно; если null, или если у parentComponent нет Frame, используется значок по умолчанию Frame; message - объект для отображения в диалоговом окне; объект Component отображается как Component; объект String отображается как строка; другие объекты преобразуются в String с помощью метода toString; title - строка заголовка диалогового окна; optionType - целое число, обозначающее доступные в диалоговом окне варианты: YES_NO_OPTION, или YES_NO_CANCEL_OPTION.; messageType - целое число, обозначающее тип сообщения; в основном используется для определения значка из настраиваемой темы оформления: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE
Returns:: целое число, указывающее выбранный пользователем вариант

showInternalConfirmDialog

public static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon)

Выводит внутренний диалоговый панельный элемент со значком, где количество вариантов определяется параметром optionType. Параметр messageType в основном используется для предоставления значка по умолчанию из темы оформления.

Parameters:: parentComponent - определяет Frame, в котором отображается диалоговое окно; если null, или если у parentComponent нет Frame, используется значок по умолчанию Frame; message - объект для отображения в диалоговом окне; объект Component отображается как Component; объект String отображается как строка; другие объекты преобразуются в String с помощью метода toString; title - строка заголовка диалогового окна; optionType - целое число, обозначающее доступные в диалоговом окне варианты: YES_NO_OPTION, или YES_NO_CANCEL_OPTION.; messageType - целое число, обозначающее тип сообщения; в основном используется для определения значка из настраиваемой темы оформления: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE; icon - значок для отображения в диалоговом окне
Returns:: целое число, указывающее выбранный пользователем вариант

showInternalOptionDialog

public static int showInternalOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue)

Выводит внутренний диалоговый панельный элемент со значком, где начальный выбор определяется параметром initialValue, а количество вариантов определяется параметром optionType.

Если optionType равно YES_NO_OPTION, или YES_NO_CANCEL_OPTION, и параметр options равен null, то варианты предоставляются темой оформления.

Параметр messageType в основном используется для предоставления значка по умолчанию из темы оформления.

Parameters:: parentComponent - определяет Frame, в котором отображается диалоговое окно; если null, или если у parentComponent нет Frame, используется значок по умолчанию Frame; message - объект для отображения в диалоговом окне; объект Component отображается как Component; объект String отображается как строка. Другие объекты преобразуются в String с помощью метода toString; title - строка заголовка диалогового окна; optionType - целое число, обозначающее доступные в диалоговом окне варианты: YES_NO_OPTION, или YES_NO_CANCEL_OPTION; messageType - целое число, обозначающее тип сообщения; в основном используется для определения значка из настраиваемой темы оформления: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE; icon - значок для отображения в диалоговом окне; options - массив объектов, обозначающий возможные варианты выбора пользователем; если объекты являются компонентами, они отображаются должным образом; не-String объекты отображаются с помощью их методов toString; если этот параметр равен null, варианты определяются темой оформления; initialValue - объект, представляющий значение по умолчанию для диалогового окна; имеет смысл только если используется options; может быть null
Returns:: целое число, указывающее выбранный пользователем вариант, или CLOSED_OPTION если пользователь закрыл диалоговое окно

showInternalInputDialog

public static String showInternalInputDialog(Component parentComponent, Object message)

Выводит внутреннее диалоговое окно с запросом ввода от пользователя, родительское к parentComponent. Диалоговое окно отображается во фрейме Component и обычно размещается под Component

Parameters:: parentComponent - родительский Component для диалогового окна; message - отображаемый Object
Returns:: ввод пользователя

showInternalInputDialog

public static String showInternalInputDialog(Component parentComponent, Object message, String title, int messageType)

Выводит внутреннее диалоговое окно с запросом ввода от пользователя, родительское к parentComponent, с заголовком title и типом сообщения messageType

Parameters:: parentComponent - родительский Component для диалогового окна; message - отображаемый Object; title - отображаемый в строке заголовка диалогового окна String; messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE или PLAIN_MESSAGE
Returns:: ввод пользователя

showInternalInputDialog

public static Object showInternalInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue)

Запрашивает ввод пользователя в блокирующем внутреннем диалоговом окне, где начальный выбор, возможные варианты и все другие параметры могут быть указаны. Пользователь сможет выбрать из selectionValues, где null подразумевает, что пользователь может вводить что угодно, обычно с помощью JTextField. initialSelectionValue - начальное значение, предлагаемое пользователю. Интерфейс пользователя самостоятельно определяет лучший способ отображения selectionValues, но обычно используется JComboBox, JList, или JTextField

Parameters:: parentComponent - родительский Component для диалогового окна; message - отображаемый Object; title - отображаемый в строке заголовка диалогового окна String; messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE; icon - отображаемый Icon значок; selectionValues - массив Objects, предоставляющий возможные варианты выбора; initialSelectionValue - значение, используемое для инициализации поля ввода
Returns:: ввод пользователя, или null если пользователь отменил ввод

createInternalFrame

public JInternalFrame createInternalFrame(Component parentComponent, String title)

Создаёт и возвращает экземпляр JInternalFrame. Внутренняя рамка создаётся со заданным заголовком и обертыванием JOptionPane. Возвращённая JInternalFrame добавляется к предку JDesktopPane parentComponent, или к родителю компонентов, если один из предков не является JDesktopPane, или если у parentComponent нет родителя, то выбрасывается RuntimeException

Parameters:: parentComponent - родительский Component для внутренней рамки; title - отображаемый в строке заголовка рамки String
Returns:: a JInternalFrame содержащий JOptionPane
Throws:: RuntimeException - если у parentComponent нет валидного родителя

getFrameForComponent

public static Frame getFrameForComponent(Component parentComponent) throws HeadlessException

Возвращает Frame указанного компонента.

Parameters:

parentComponent - Component для проверки наличия Frame

Returns:

Frame, содержащий компонент, или getRootFrame, если компонент является null, или у него нет валидного родителя Frame

Throws:

HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

See Also:

getDesktopPaneForComponent

public static JDesktopPane getDesktopPaneForComponent(Component parentComponent)

Возвращает рабочую область для указанного компонента.

Parameters:: parentComponent - проверяемый компонент для поиска рабочей области
Returns:: рабочая область, содержащая компонент, или null, если компонент является корневым или у него нет предка, являющегося рабочей областью

setRootFrame

public static void setRootFrame(Frame newRootFrame)

Устанавливает фрейм, используемый для методов класса, где фрейм не предоставлен.

Примечание: Рекомендуется вместо этого метода использовать действительного родителя.

Parameters:: newRootFrame - фрейм по умолчанию

getRootFrame

public static Frame getRootFrame() throws HeadlessException

Возвращает фрейм, используемый для методов класса, где фрейм не предоставлен.

Returns:

фрейм по умолчанию

Throws:

HeadlessException - если метод GraphicsEnvironment.isHeadless возвращает true

See Also:

setUI

@BeanProperty(hidden=true, description="The UI object that implements the optionpane\'s LookAndFeel") public void setUI(OptionPaneUI ui)

Устанавливает объект UI, реализующий L&F для этого компонента.

Parameters:

ui - объект L&F

See Also:

UIDefaults.getUI(javax.swing.JComponent)

getUI

public OptionPaneUI getUI()

Возвращает объект UI, реализующий L&F для этого компонента.

Overrides:: getUI в классе JComponent
Returns:: объект UI

updateUI

public void updateUI()

Уведомление от L&F о том, что изменился вид. Заменяет текущий объект UI последней версией из L&F.

Overrides:

updateUI в классе JComponent

See Also:

JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

Возвращает имя класса UI, реализующего L&F для этого компонента.

Overrides:

getUIClassID в классе JComponent

Returns:

строка "OptionPaneUI"

See Also:

setMessage

@BeanProperty(preferred=true, description="The optionpane\'s message object.") public void setMessage(Object newMessage)

Устанавливает объект сообщения для диалогового окна.

Parameters:

newMessage - отображаемый объект сообщения

See Also:

getMessage()

getMessage

public Object getMessage()

Возвращает объект сообщения, отображаемый в этом окне.

Returns:

отображаемый объект сообщения

See Also:

setMessage(java.lang.Object)

setIcon

@BeanProperty(preferred=true, description="The option pane\'s type icon.") public void setIcon(Icon newIcon)

Устанавливает отображаемый значок. Если значок не указан, виджет не отображает значок.

Parameters:

newIcon - отображаемый значок

See Also:

getIcon()

getIcon

public Icon getIcon()

Возвращает отображаемый значок.

Returns:

отображаемый значок

See Also:

setIcon(javax.swing.Icon)

setValue

@BeanProperty(preferred=true, description="The option pane\'s value object.") public void setValue(Object newValue)

Устанавливает выбранное пользователем значение.

Parameters:

newValue - выбранное значение

See Also:

getValue()

getValue

public Object getValue()

Возвращает значение, выбранное пользователем. null означает, что пользователь еще не сделал выбор, -1 означает, что пользователь закрыл окно без выбора. В противном случае возвращаемое значение будет одним из определенных в этом объекте вариантов.

Returns:

выбранное пользователем значение, null если пользователь еще не выбрал, -1 если пользователь закрыл окно без выбора

See Also:

setValue(java.lang.Object)

setOptions

@BeanProperty(description="The option pane\'s options objects.") public void setOptions(Object[] newOptions)

Устанавливает варианты, которые отображаются в окне. Если элемент в массиве является кнопкой, он добавляется непосредственно в окно, в противном случае создаётся кнопка для элемента.

Parameters:

newOptions - массив вариантов, которые создают кнопки, по которым может кликнуть пользователь, или произвольные объекты для добавления в окно

See Also:

getOptions()

getOptions

public Object[] getOptions()

Возвращает доступные варианты для выбора.

Returns:

массив вариантов, доступных пользователю

See Also:

setOptions(java.lang.Object[])

setInitialValue

@BeanProperty(preferred=true, description="The option pane\'s initial value object.") public void setInitialValue(Object newInitialValue)

Устанавливает начальное значение, которое будет выбрано по умолчанию — элемент, который получает фокус при отображении окна.

Parameters:

newInitialValue - элемент, который получит фокус при отображении окна

See Also:

getInitialValue()

getInitialValue

public Object getInitialValue()

Возвращает начальное значение.

Returns:

элемент, который получит фокус при отображении окна

See Also:

setInitialValue(java.lang.Object)

setMessageType

@BeanProperty(preferred=true, description="The option pane\'s message type.") public void setMessageType(int newType)

Устанавливает тип сообщения для диалогового окна. Тип сообщения используется виджетом для определения отображаемого значка (если он не задан), а также потенциально для вывода сообщения.

Parameters:

newType - целое число, определяющее вид сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE

Throws:

RuntimeException - если newType не является одним из допустимых значений, перечисленных выше

See Also:

getMessageType()

getMessageType

public int getMessageType()

Возвращает тип сообщения.

Returns:

целое число, определяющее тип сообщения

See Also:

setMessageType(int)

setOptionType

@BeanProperty(preferred=true, description="The option pane\'s option type.") public void setOptionType(int newType)

Устанавливает тип вариантов для отображения. Тип вариантов используется виджетом для определения отображаемых кнопок (если не указаны варианты).

Parameters:

newType - целое число, определяющее тип отображаемых вариантов: DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION, или OK_CANCEL_OPTION

Throws:

RuntimeException - если newType не является одним из допустимых значений, перечисленных выше

See Also:

getOptionType()
setOptions(java.lang.Object[])

getOptionType

public int getOptionType()

Возвращает тип отображаемых вариантов.

Returns:

целое число, определяющее тип вариантов

See Also:

setOptionType(int)

setSelectionValues

@BeanProperty(description="The option pane\'s selection values.") public void setSelectionValues(Object[] newValues)

Устанавливает значения выбора для области ввода, которая предоставляет пользователю список элементов для выбора. (Пользовательский интерфейс предоставляет виджет для выбора одного из значений.) Значение null подразумевает, что пользователь может вводить любые значения, обычно с помощью JTextField.

Устанавливает wantsInput в значение true. Используйте setInitialSelectionValue для указания значения, которое изначально выбрано. После активации области ввода, inputValue устанавливается в значение, выбранное пользователем.

Parameters:

newValues - массив Objects для отображения пользователю (обычно в списке или раскрывающемся списке), из которого пользователь может произвести выбор

See Also:

setWantsInput(boolean)
setInitialSelectionValue(java.lang.Object)
getSelectionValues()

getSelectionValues

public Object[] getSelectionValues()

Возвращает значения выбора ввода.

Returns:

массив Objects для выбора пользователем

See Also:

setSelectionValues(java.lang.Object[])

setInitialSelectionValue

@BeanProperty(description="The option pane\'s initial selection value object.") public void setInitialSelectionValue(Object newValue)

Устанавливает значение ввода, которое изначально отображается как выбранное для пользователя. Используется только если wantsInput равно true.

Parameters:

newValue - значение, выбранное по умолчанию

See Also:

setSelectionValues(java.lang.Object[])
getInitialSelectionValue()

getInitialSelectionValue

public Object getInitialSelectionValue()

Возвращает значение ввода, которое отображается как изначально выбранное для пользователя.

Returns:

изначально выбранное значение

See Also:

setInitialSelectionValue(java.lang.Object)
setSelectionValues(java.lang.Object[])

setInputValue

@BeanProperty(preferred=true, description="The option pane\'s input value object.") public void setInputValue(Object newValue)

Устанавливает значение ввода, которое было выбрано или введено пользователем. Используется только если wantsInput равно true. Обратите внимание, что этот метод вызывается внутренне диалоговым окном (в ответ на действие пользователя) и обычно не должен вызываться клиентскими программами. Чтобы установить значение ввода, которое изначально отображается как выбранное для пользователя, используйте setInitialSelectionValue.

Parameters:

newValue - Object используется для установки значения, указанного пользователем (обычно в поле ввода текста)

See Also:

setSelectionValues(java.lang.Object[])
setInitialSelectionValue(java.lang.Object)
setWantsInput(boolean)
getInputValue()

getInputValue

public Object getInputValue()

Возвращает значение, введенное пользователем, если wantsInput равно true.

Returns:

значение, указанное пользователем, если это было одно из объектов, или String если это было значение, введенное в поле

See Also:

setSelectionValues(java.lang.Object[])
setWantsInput(boolean)
setInputValue(java.lang.Object)

getMaxCharactersPerLineCount

@BeanProperty(bound=false) public int getMaxCharactersPerLineCount()

Возвращает максимальное количество символов, которые следует разместить на строке в сообщении. По умолчанию возвращает Integer.MAX_VALUE. Значение можно изменить, переопределив этот метод в подклассе.

Returns:: целое число, задающее максимальное количество символов на строке

setWantsInput

@BeanProperty(preferred=true, description="Flag which allows the user to input a value.") public void setWantsInput(boolean newValue)

Устанавливает свойство wantsInput. Если newValue равно true, компонент ввода (например, поле ввода текста или раскрывающийся список), родитель которого является parentComponent, предоставляется для ввода пользователем. Если getSelectionValues возвращает массив, отличный от пустого, значение ввода является одним из объектов в этом массиве. В противном случае значение ввода равно тому, что ввел пользователь.

Это связанное свойство.

Parameters:

newValue - если true, компонент ввода, родитель которого является parentComponent, предоставляется для ввода пользователем.

See Also:

setSelectionValues(java.lang.Object[])
setInputValue(java.lang.Object)

getWantsInput

public boolean getWantsInput()

Возвращает значение свойства wantsInput.

Returns:

true, если будет предоставлен компонент ввода

See Also:

setWantsInput(boolean)

selectInitialValue

public void selectInitialValue()

Запрашивает выбор начального значения, что приведет к фокусировке на начальном значении. Этот метод должен вызываться после того, как окно, содержащее диалоговое окно, станет видимым.

paramString

protected String paramString()

Возвращает строковое представление этого JOptionPane. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не null.

Overrides:: paramString в классе JComponent
Returns:: строковое представление этого JOptionPane

getAccessibleContext

@BeanProperty(bound=false, expert=true, description="The AccessibleContext associated with this option pane") public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext связанное с этим JOptionPane. Для диалоговых окон с выбором значений AccessibleContext имеет вид AccessibleJOptionPane. Новый экземпляр AccessibleJOptionPane создается при необходимости.

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Returns:: AccessibleJOptionPane, используемый как AccessibleContext для этого AccessibleJOptionPane

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/swing/JOptionPane.html