Класс 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 в качестве родителя, и диалоговое окно будет центрировано на экране (в зависимости от L&F).

message

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

Object[]

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

Component

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

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

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

Примеры:

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


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

Показать внутреннее диалоговое окно с информацией, содержащее сообщение 'information':

 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.

Since:

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`	Тип, означающий, что вид и ощущения не должны предоставлять никаких вариантов — использовать только опции из `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

Тип, означающий, что виджет не должен предоставлять собственных опций — следует использовать только опции из 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

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

См. также:

Свойство ICON

public static final String ICON_PROPERTY

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

См. также:

Свойство MESSAGE

public static final String MESSAGE_PROPERTY

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

См. также:

Свойство VALUE

public static final String VALUE_PROPERTY

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

См. также:

Свойство OPTIONS

public static final String OPTIONS_PROPERTY

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

См. также:

Свойство INITIAL_VALUE

public static final String INITIAL_VALUE_PROPERTY

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

См. также:

Свойство MESSAGE_TYPE

public static final String MESSAGE_TYPE_PROPERTY

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

См. также:

Свойство OPTION_TYPE

public static final String OPTION_TYPE_PROPERTY

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

См. также:

Свойство SELECTION_VALUES

public static final String SELECTION_VALUES_PROPERTY

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

См. также:

Свойство INITIAL_SELECTION_VALUE

public static final String INITIAL_SELECTION_VALUE_PROPERTY

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

См. также:

Свойство INPUT_VALUE

public static final String INPUT_VALUE_PROPERTY

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

См. также:

Свойство WANTS_INPUT

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

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

JOptionPane

public JOptionPane(Object message, int messageType)

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

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

JOptionPane

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

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

Parameters:: 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 для отображения сообщения с указанным типом сообщения, опциями и значком.

Parameters:: 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 - отображаемый значок

JOptionPane

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

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

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

Parameters:: 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 - варианты, которые пользователь может выбрать

JOptionPane

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

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

Parameters:: 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

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

Parameters:

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

Returns:

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

Throws:

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

See Also:

showInputDialog

public static String showInputDialog(Object message, Object initialSelectionValue)

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

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

showInputDialog

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

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

Parameters:

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

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

Returns:

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

Throws:

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

See Also:

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 - заголовок для отображения в диалоге

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

Parameters:

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

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

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

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

Returns:

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

Throws:

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

See Also:

showConfirmDialog

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

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

Parameters:

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

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

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

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

Returns:

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

Throws:

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

See Also:

showOptionDialog

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

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

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

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

Parameters:

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

Returns:

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

Throws:

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

See Also:

createDialog

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

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

Parameters:

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

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

Returns:

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

Throws:

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

See Also:

createDialog

public JDialog createDialog(String title) throws HeadlessException

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

Parameters:

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

Returns:

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

Throws:

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

Since:

1.6

See Also:

showInternalMessageDialog

public static void showInternalMessageDialog(Component parentComponent, Object message)

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

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

showInternalMessageDialog

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

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

Parameters:: 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)

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

Parameters:: 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)

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

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

showInternalConfirmDialog

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

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

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

showInternalConfirmDialog

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

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

Parameters:: 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
Returns:: целое число, указывающее выбранный пользователем вариант

showInternalConfirmDialog

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

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

Parameters:: 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 - значок для отображения в диалоге
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, варианты предоставляются Look and Feel.

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

Parameters:: 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, варианты определяются Look and Feel; 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 зависит от UI, но обычно используется 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 - проверяемый компонент для поиска рабочего пространства
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:

getUI

public OptionPaneUI getUI()

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

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

updateUI

public void updateUI()

Уведомление от 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 - отображаемое сообщение

See Also:

getMessage

public Object getMessage()

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

Returns:

отображаемое сообщение

See Also:

setIcon

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

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

Parameters:

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

See Also:

getIcon

public Icon getIcon()

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

Returns:

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

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()

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

Returns:

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

See Also:

setOptions

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

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

Parameters:

newOptions - массив элементов, создающих кнопки, или произвольные элементы для добавления в окно

See Also:

getOptions

public Object[] getOptions()

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

Returns:

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

See Also:

setInitialValue

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

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

Parameters:

newInitialValue - элемент, получающий начальный фокус

See Also:

getInitialValue

public Object getInitialValue()

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

Returns:

элемент, получающий начальный фокус

See Also:

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

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

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

Parameters:

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

See Also:

getWantsInput

public boolean getWantsInput()

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

Returns:

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

See Also:

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, 2023, 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/21/docs/api/java.desktop/javax/swing/JOptionPane.html