Класс 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, содержащий его, используется в качестве родительского Frame для диалогового окна, а его координаты на экране используются для размещения диалогового окна. Как правило, диалоговое окно размещается непосредственно под компонентом. Этот параметр может быть null, в этом случае в качестве родителя используется значение по умолчанию Frame, и диалоговое окно будет центрировано на экране (в зависимости от визуального стиля).

сообщение

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

Object[]

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

Компонент

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

Иконка

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

другие

Объект преобразуется в String путём вызова его метода toString. Результат оборачивается в JLabel и отображается.

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

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

ERROR_MESSAGE

INFORMATION_MESSAGE

WARNING_MESSAGE

QUESTION_MESSAGE

PLAIN_MESSAGE

тип параметров

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

DEFAULT_OPTION

YES_NO_OPTION

YES_NO_CANCEL_OPTION

OK_CANCEL_OPTION

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

параметры

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

Компонент

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

Иконка

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

другой

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

иконка

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

заголовок

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

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

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

При изменении выбора вызывается 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);

Показать диалоговое окно с предупреждением с параметрами OK, ОТМЕНА, заголовком 'Предупреждение' и сообщением 'Нажмите OK, чтобы продолжить':

 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.setVisible(true);
     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.

С тех пор:

1.2

См. также:

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

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`	Тип, означающий, что Look and Feel не должен предоставлять никаких опций — следует использовать только опции из `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)`	Возвращает рабочую область (desktop pane) указанного компонента.
`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()`	Возвращает объект UI, который реализует L&F для этого компонента.
`String`	`getUIClassID()`	Возвращает имя класса UI, который реализует 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)`	Устанавливает объект 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` о том, что изменился внешний вид.

Методы, объявленные в классе 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

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

См. также:

YES_NO_OPTION

public static final int YES_NO_OPTION

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

См. также:

YES_NO_CANCEL_OPTION

public static final int YES_NO_CANCEL_OPTION

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

См. также:

OK_CANCEL_OPTION

public static final int OK_CANCEL_OPTION

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

См. также:

YES_OPTION

public static final int YES_OPTION

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

См. также:

NO_OPTION

public static final int NO_OPTION

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

См. также:

CANCEL_OPTION

public static final int CANCEL_OPTION

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

См. также:

OK_OPTION

public static final int OK_OPTION

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

См. также:

CLOSED_OPTION

public static final int CLOSED_OPTION

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

См. также:

ERROR_MESSAGE

public static final int ERROR_MESSAGE

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

См. также:

INFORMATION_MESSAGE

public static final int INFORMATION_MESSAGE

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

См. также:

WARNING_MESSAGE

public static final int WARNING_MESSAGE

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

См. также:

QUESTION_MESSAGE

public static final int QUESTION_MESSAGE

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

См. также:

PLAIN_MESSAGE

public static final int PLAIN_MESSAGE

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

См. также:

ICON_PROPERTY

public static final String ICON_PROPERTY

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

См. также:

MESSAGE_PROPERTY

public static final String MESSAGE_PROPERTY

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

См. также:

VALUE_PROPERTY

public static final String VALUE_PROPERTY

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

См. также:

OPTIONS_PROPERTY

public static final String OPTIONS_PROPERTY

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

См. также:

INITIAL_VALUE_PROPERTY

public static final String INITIAL_VALUE_PROPERTY

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

См. также:

MESSAGE_TYPE_PROPERTY

public static final String MESSAGE_TYPE_PROPERTY

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

См. также:

OPTION_TYPE_PROPERTY

public static final String OPTION_TYPE_PROPERTY

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

См. также:

SELECTION_VALUES_PROPERTY

public static final String SELECTION_VALUES_PROPERTY

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

См. также:

INITIAL_SELECTION_VALUE_PROPERTY

public static final String INITIAL_SELECTION_VALUE_PROPERTY

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

См. также:

INPUT_VALUE_PROPERTY

public static final String INPUT_VALUE_PROPERTY

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

См. также:

WANTS_INPUT_PROPERTY

public static final String WANTS_INPUT_PROPERTY

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

См. также:

icon

protected transient Icon icon

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

message

protected transient Object message

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

options

protected transient Object[] options

Параметры для отображения пользователю.

initialValue

protected transient Object initialValue

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

messageType

protected int messageType

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

optionType

protected int optionType

Тип параметра, один из DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION или OK_CANCEL_OPTION.

value

protected transient Object value

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

selectionValues

protected transient Object[] selectionValues

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

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 для отображения сообщения, используя тип сообщения plain-message и параметры по умолчанию, предоставляемые пользовательским интерфейсом.

Параметры:: 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 он отправляет сообщения setValue в созданный 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; 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

См. также:

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

См. также:

showInputDialog

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

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

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

showInputDialog

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

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

Parameters:

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

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

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

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

Returns:

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

Throws:

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

See Also:

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:

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:

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:

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:

showConfirmDialog

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

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

Parameters:

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

Returns:

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

Throws:

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

See Also:

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:

showConfirmDialog

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

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

Параметры:

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

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

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

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

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

Возвращает:

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

Исключения:

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

См. также:

showConfirmDialog

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

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

Параметры:

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

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

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

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

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

Возвращает:

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

Исключения:

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

См. также:

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 в основном используется для задания значка по умолчанию из внешнего вида.

Параметры:

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

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

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

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

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

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

Возвращает:

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

Исключения:

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

См. также:

createDialog

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

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

См. также:

createDialog

public JDialog createDialog(String title) throws HeadlessException

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

Параметры:

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

Возвращает:

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

Исключения:

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

С момента:

1.6

См. также:

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 в основном используется для предоставления иконки по умолчанию из Look and Feel.

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

showInternalConfirmDialog

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

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

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

showInternalOptionDialog

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

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

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

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

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

showInternalInputDialog

public static String showInternalInputDialog(Component parentComponent, Object message)

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

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

showInternalInputDialog

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

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

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

showInternalInputDialog

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

Запрашивает у пользователя ввод в блокирующем внутреннем диалоговом окне, где можно указать начальный выбор, возможные варианты выбора и другие опции. Пользователь может выбрать из selectionValues, где null подразумевает, что пользователь может ввести что угодно, обычно с помощью JTextField. initialSelectionValue является начальным значением, которое отображается пользователю. Интерфейс пользователя сам решает, как лучше всего представить 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:: 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 - Component для проверки на наличие области рабочего стола
Returns:: объект JDesktopPane, содержащий компонент, или null, если компонент является null или не имеет предка, являющегося JInternalFrame

setRootFrame

public static void setRootFrame(Frame newRootFrame)

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

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

Parameters:: newRootFrame - используемая по умолчанию Frame

getRootFrame

public static Frame getRootFrame() throws HeadlessException

Возвращает используемую по умолчанию Frame для методов класса, в которых рамка не предоставлена.

Returns:

используемую по умолчанию Frame

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 OptionPaneUI

See Also:

getUI

public OptionPaneUI getUI()

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

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

updateUI

public void updateUI()

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

Overrides:

updateUI в классе JComponent

See Also:

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 - отображаемый Object

See Also:

getMessage

public Object getMessage()

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

Returns:

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

See Also:

setIcon

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

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

Parameters:

newIcon - отображаемый Icon

See Also:

getIcon

public Icon getIcon()

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

Returns:

отображаемый Icon

See Also:

setValue

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

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

Parameters:

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

See Also:

getValue

public Object getValue()

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

Returns:

выбранное пользователем Object, UNINITIALIZED_VALUE, если пользователь ещё не сделал выбор, или null, если пользователь закрыл окно, не сделав выбор

See Also:

setOptions

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

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

Parameters:

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

See Also:

getOptions

public Object[] getOptions()

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

Returns:

массив Objects, предоставляющий варианты пользователя

See Also:

setInitialValue

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

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

Parameters:

newInitialValue - Object, который получает начальный фокус клавиатуры

See Also:

getInitialValue

public Object getInitialValue()

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

Returns:

Object, который получает начальный фокус клавиатуры

See Also:

setMessageType

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

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

Parameters:

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

Throws:

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

See Also:

getMessageType

public int getMessageType()

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

Returns:

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

See Also:

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

public int getOptionType()

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

Returns:

целое число, определяющее параметры, выбираемые пользователем

See Also:

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:

getSelectionValues

public Object[] getSelectionValues()

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

Returns:

массив Objects, которые пользователь может выбрать

See Also:

setInitialSelectionValue

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

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

Parameters:

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

See Also:

getInitialSelectionValue

public Object getInitialSelectionValue()

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

Returns:

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

See Also:

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:

getInputValue

public Object getInputValue()

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

Returns:

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

See Also:

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 возвращает массив, отличный от null, значение ввода является одним из объектов в этом массиве. В противном случае значение ввода — то, что ввел пользователь.

Это свойство привязки.

Parameters:

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

See Also:

getWantsInput

public boolean getWantsInput()

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

Возвращает:

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

См. также:

selectInitialValue

public void selectInitialValue()

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

paramString

protected String paramString()

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

Переопределяет:: paramString в классе JComponent
Возвращает:: строковое представление этого JOptionPane

getAccessibleContext

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

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: AccessibleJOptionPane, который служит AccessibleContext для этого AccessibleJOptionPane

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JOptionPane.html