Класс JOptionPane

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JOptionPane

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

public class JOptionPane
extends JComponent
implements Accessible

JOptionPane упрощает вывод стандартного диалогового окна, которое запрашивает у пользователя значение или сообщает ему что-то. Для получения информации об использовании JOptionPane, см. Как создать диалоговые окна, раздел в Руководстве по Java.

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

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

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

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

Иконка	Сообщение
	Значение ввода
Кнопки выбора

Основной вид одного из этих диалоговых окон, как правило, похож на изображенный справа, хотя различные визуальные стили (look-and-feels) в конечном итоге определяют окончательный результат. В частности, визуальные стили будут изменять макет, чтобы соответствовать свойству ComponentOrientation диалогового окна.

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

parentComponent

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

message

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

Object[]: Массив объектов интерпретируется как серия сообщений (по одному на объект), расположенных в вертикальной стопке. Интерпретация рекурсивная — каждый объект в массиве интерпретируется в соответствии со своим типом.
Component: Компонент отображается в диалоговом окне.
Icon: Иконка Icon вложена в JLabel и отображается в диалоговом окне.
others: Объект преобразуется в String с помощью его toString метода. Результат вкладывается в JLabel и отображается.

messageType

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

ERROR_MESSAGE
INFORMATION_MESSAGE
WARNING_MESSAGE
QUESTION_MESSAGE
PLAIN_MESSAGE

optionType

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

DEFAULT_OPTION
YES_NO_OPTION
YES_NO_CANCEL_OPTION
OK_CANCEL_OPTION

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

options

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

Component: Компонент добавляется непосредственно в строку кнопок.
Icon: Создаётся JButton с этим как меткой.
other: Object преобразуется в строку с помощью метода toString и результат используется в качестве метки для JButton.

icon

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

title

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

initialValue

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

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

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

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

YES_OPTION
NO_OPTION
CANCEL_OPTION
OK_OPTION
CLOSED_OPTION

Примеры:

Показать диалоговое окно об ошибке с сообщением "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.show();
     Object selectedValue = pane.getValue();
     if(selectedValue == null)
       return CLOSED_OPTION;
     //If there is not an array of option buttons:
     if(options == null) {
       if(selectedValue instanceof Integer)
          return ((Integer)selectedValue).intValue();
       return CLOSED_OPTION;
     }
     //If there is an array of option buttons:
     for(int counter = 0, maxCounter = options.length;
        counter < maxCounter; counter++) {
        if(options[counter].equals(selectedValue))
        return counter;
     }
     return CLOSED_OPTION;

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

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

См. также:: JInternalFrame

Вложенные классы

Модификатор и тип	Класс и описание
`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

Поля

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

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

Конструкторы

Конструктор и описание
`JOptionPane()` Создает `JOptionPane` с тестовым сообщением.
`JOptionPane(Object message)` Создает экземпляр `JOptionPane` для отображения сообщения с использованием типа сообщения plain-message и стандартных опций, предоставляемых пользовательским интерфейсом.
`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()` Возвращает объект 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` о том, что L&F изменился.

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

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

Методы, унаследованные от класса 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, 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

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

Поля

UNINITIALIZED_VALUE

public static final Object UNINITIALIZED_VALUE

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

DEFAULT_OPTION

public static final int DEFAULT_OPTION

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

См. также:: Constant Field Values

YES_NO_OPTION

public static final int YES_NO_OPTION

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

См. также:: Constant Field Values

YES_NO_CANCEL_OPTION

public static final int YES_NO_CANCEL_OPTION

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

См. также:: Constant Field Values

OK_CANCEL_OPTION

public static final int OK_CANCEL_OPTION

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

См. также:: Constant Field Values

YES_OPTION

public static final int YES_OPTION

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

См. также:: Constant Field Values

NO_OPTION

public static final int NO_OPTION

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

См. также:: Constant Field Values

CANCEL_OPTION

public static final int CANCEL_OPTION

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

См. также:: Constant Field Values

OK_OPTION

public static final int OK_OPTION

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

См. также:: Constant Field Values

CLOSED_OPTION

public static final int CLOSED_OPTION

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

См. также:: Constant Field Values

ERROR_MESSAGE

public static final int ERROR_MESSAGE

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

См. также:: Constant Field Values

INFORMATION_MESSAGE

public static final int INFORMATION_MESSAGE

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

См. также:: Constant Field Values

WARNING_MESSAGE

public static final int WARNING_MESSAGE

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

См. также:: Constant Field Values

QUESTION_MESSAGE

public static final int QUESTION_MESSAGE

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

См. также:: Constant Field Values

PLAIN_MESSAGE

public static final int PLAIN_MESSAGE

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

См. также:: Constant Field Values

ICON_PROPERTY

public static final String ICON_PROPERTY

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

См. также:: Constant Field Values

MESSAGE_PROPERTY

public static final String MESSAGE_PROPERTY

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

См. также:: Constant Field Values

VALUE_PROPERTY

public static final String VALUE_PROPERTY

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

См. также:: Constant Field Values

OPTIONS_PROPERTY

public static final String OPTIONS_PROPERTY

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

См. также:: Constant Field Values

INITIAL_VALUE_PROPERTY

public static final String INITIAL_VALUE_PROPERTY

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

См. также:: Constant Field Values

MESSAGE_TYPE_PROPERTY

public static final String MESSAGE_TYPE_PROPERTY

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

См. также:: Constant Field Values

OPTION_TYPE_PROPERTY

public static final String OPTION_TYPE_PROPERTY

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

См. также:: Constant Field Values

SELECTION_VALUES_PROPERTY

public static final String SELECTION_VALUES_PROPERTY

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

См. также:: Constant Field Values

INITIAL_SELECTION_VALUE_PROPERTY

public static final String INITIAL_SELECTION_VALUE_PROPERTY

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

См. также:: Constant Field Values

INPUT_VALUE_PROPERTY

public static final String INPUT_VALUE_PROPERTY

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

См. также:: Constant Field Values

WANTS_INPUT_PROPERTY

public static final String WANTS_INPUT_PROPERTY

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

См. также:: Constant Field Values

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

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

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
См. также:: GraphicsEnvironment.isHeadless()

showInputDialog

public static String showInputDialog(Object message,
                                     Object initialSelectionValue)

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

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

showInputDialog

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

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

Параметры:: parentComponent - родительское Component для диалогового окна; message - отображаемый Object
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

showInputDialog

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

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

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

showInputDialog

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

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

Параметры:: parentComponent - родительское Component для диалогового окна; message - отображаемый Object; title - заголовок для отображения в строке заголовка диалогового окна; messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

showInputDialog

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

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

Параметры:: parentComponent - родительское Component для диалогового окна; message - отображаемый Object; title - заголовок для отображения в строке заголовка диалогового окна; messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE; icon - отображаемое Icon изображение; selectionValues - массив Objects, предоставляющих возможные варианты выбора; initialSelectionValue - значение, используемое для инициализации поля ввода
Возвращает:: ввод пользователя или null в случае отмены ввода пользователем
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

showMessageDialog

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

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

Параметры:: parentComponent - определяет Frame отображения диалогового окна; если null, или если у parentComponent нет Frame, используется по умолчанию Frame; message - отображаемый Object
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

showMessageDialog

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

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

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

showMessageDialog

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

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

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

showConfirmDialog

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

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

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

showConfirmDialog

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

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

Параметры:: parentComponent - определяет Frame отображения диалогового окна; если null, или если у parentComponent нет Frame, используется значение по умолчанию Frame; message - отображаемый Object; title - строка заголовка диалогового окна; optionType - целое число, определяющее доступные опции в диалоговом окне: YES_NO_OPTION, YES_NO_CANCEL_OPTION, или OK_CANCEL_OPTION
Возвращаемое значение:: целое число, указывающее выбранную пользователем опцию
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

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
См. также:: GraphicsEnvironment.isHeadless()

showConfirmDialog

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

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

Параметры:: parentComponent - определяет Frame отображения диалогового окна; если null, или если у parentComponent нет Frame, используется значение по умолчанию Frame; 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
См. также:: GraphicsEnvironment.isHeadless()

showOptionDialog

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

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

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

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

Параметры:: parentComponent - определяет Frame отображения диалогового окна; если null, или если у parentComponent нет Frame, используется значение по умолчанию Frame; message - отображаемый Object; title - строка заголовка диалогового окна; optionType - целое число, определяющее доступные опции в диалоговом окне: DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION, или OK_CANCEL_OPTION; messageType - целое число, определяющее тип сообщения, в основном используется для определения значка из темы оформления: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE; icon - значок для отображения в диалоговом окне; options - массив объектов, указывающих возможные варианты выбора пользователем; если объекты являются компонентами, они отображаются должным образом; не-String объекты отображаются с помощью их методов toString; если этот параметр null, опции определяются темой оформления; initialValue - объект, представляющий стандартный выбор для диалогового окна; имеет смысл только если options используется; может быть null
Возвращаемое значение:: целое число, указывающее выбранную пользователем опцию, или CLOSED_OPTION если пользователь закрыл диалоговое окно
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

createDialog

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

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

Параметры:: parentComponent - определяет окно, в котором отображается диалоговое окно; если у parentComponent нет Frame, используется значение по умолчанию Frame; title - строка заголовка диалогового окна
Возвращаемое значение:: новое диалоговое окно JDialog, содержащее этот экземпляр
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

createDialog

public JDialog createDialog(String title)
                     throws HeadlessException

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

Parameters:: title - строка заголовка для диалогового окна
Returns:: новый JDialog содержащий этот экземпляр
Throws:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
Since:: 1.6
See Also:: GraphicsEnvironment.isHeadless()

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 с помощью метода toString; 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

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.

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

createInternalFrame

public JInternalFrame createInternalFrame(Component parentComponent,
                                          String title)

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

Параметры:: parentComponent — родительский Component для внутренней рамки; title — отображаемый String в строке заголовка рамки
Возвращаемое значение:: JInternalFrame, содержащий JOptionPane
Исключения:: RuntimeException — если у parentComponent нет корректного родителя

getFrameForComponent

public static Frame getFrameForComponent(Component parentComponent)
                                  throws HeadlessException

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

Параметры:: parentComponent — Component для проверки наличия Frame
Возвращаемое значение:: Frame , содержащий компонент, или getRootFrame, если компонент является null, или у него нет корректного родительского Frame.
Исключения:: HeadlessException — если GraphicsEnvironment.isHeadless возвращает true
См. также:: getRootFrame(), GraphicsEnvironment.isHeadless()

getDesktopPaneForComponent

public static JDesktopPane getDesktopPaneForComponent(Component parentComponent)

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

Параметры:: parentComponent — Component для проверки наличия рабочей области
Возвращаемое значение:: рабочую область, содержащую компонент, или null, если компонент является null или у него нет предка, являющегося JInternalFrame

setRootFrame

public static void setRootFrame(Frame newRootFrame)

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

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

Параметры:: newRootFrame — используемая по умолчанию Frame

getRootFrame

public static Frame getRootFrame()
                          throws HeadlessException

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

Возвращаемое значение:: используемая по умолчанию Frame
Исключения:: HeadlessException — если GraphicsEnvironment.isHeadless возвращает true
См. также:: setRootFrame(java.awt.Frame), GraphicsEnvironment.isHeadless()

setUI

public void setUI(OptionPaneUI ui)

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

Параметры:: ui — объект L&F OptionPaneUI
См. также:: UIDefaults.getUI(javax.swing.JComponent)

getUI

public OptionPaneUI getUI()

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

Возвращаемое значение:: объект OptionPaneUI

updateUI

public void updateUI()

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

Переопределяет:: updateUI в классе JComponent
См. также:: JComponent.updateUI()

getUIClassID

public String getUIClassID()

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

Переопределяет:: getUIClassID в классе JComponent
Возвращаемое значение:: строка "OptionPaneUI"
См. также:: JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

setMessage

public void setMessage(Object newMessage)

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

Параметры:: newMessage — отображаемый Object
См. также:: getMessage()

getMessage

public Object getMessage()

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

Возвращаемое значение:: отображаемый Object
См. также:: setMessage(java.lang.Object)

setIcon

public void setIcon(Icon newIcon)

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

Параметры:: newIcon — отображаемое Icon
См. также:: getIcon()

getIcon

public Icon getIcon()

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

Возвращаемое значение:: отображаемое Icon
См. также:: setIcon(javax.swing.Icon)

setValue

public void setValue(Object newValue)

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

Параметры:: newValue — выбранное значение
См. также:: getValue()

getValue

public Object getValue()

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

Возвращаемое значение:: выбранное пользователем Object, UNINITIALIZED_VALUE если пользователь ещё не сделал выбор, или null если пользователь закрыл окно без выбора.
См. также:: setValue(java.lang.Object)

setOptions

public void setOptions(Object[] newOptions)

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

Параметры:: newOptions — массив Objects, создающий кнопки, которые пользователь может нажать, или произвольные Components для добавления на панель
См. также:: getOptions()

getOptions

public Object[] getOptions()

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

Возвращаемое значение:: массив Objects, представляющий варианты выбора пользователя
См. также:: setOptions(java.lang.Object[])

setInitialValue

public void setInitialValue(Object newInitialValue)

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

Параметры:: newInitialValue — Object, который получит начальный фокус клавиатуры
См. также:: getInitialValue()

getInitialValue

public Object getInitialValue()

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

Возвращаемое значение:: Object , который получит начальный фокус клавиатуры
См. также:: setInitialValue(java.lang.Object)

setMessageType

public void setMessageType(int newType)

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

Параметры:: newType — целое число, определяющее тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, или PLAIN_MESSAGE
Исключения:: RuntimeException — если newType не соответствует одному из перечисленных значений
См. также:: getMessageType()

getMessageType

public int getMessageType()

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

Возвращает:: целое число, определяющее тип сообщения
См. также:: setMessageType(int)

setOptionType

public void setOptionType(int newType)

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

Параметры:: newType — целое число, определяющее типы опций, которые должно отобразить визуальное оформление: DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION, или OK_CANCEL_OPTION
Исключения:: RuntimeException — если newType не соответствует одному из перечисленных значений
См. также:: getOptionType(), setOptions(java.lang.Object[])

getOptionType

public int getOptionType()

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

Возвращает:: целое число, определяющее доступные пользователю опции
См. также:: setOptionType(int)

setSelectionValues

public void setSelectionValues(Object[] newValues)

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

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

Параметры:: newValues — массив значений Objects, которые должны отображаться пользователю (обычно в списке или выпадающем списке) для выбора
См. также:: setWantsInput(boolean), setInitialSelectionValue(java.lang.Object), getSelectionValues()

getSelectionValues

public Object[] getSelectionValues()

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

Возвращает:: массив значений Objects, которые пользователь может выбрать
См. также:: setSelectionValues(java.lang.Object[])

setInitialSelectionValue

public void setInitialSelectionValue(Object newValue)

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

Параметры:: newValue — значение, выбранное по умолчанию
См. также:: setSelectionValues(java.lang.Object[]), getInitialSelectionValue()

getInitialSelectionValue

public Object getInitialSelectionValue()

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

Возвращает:: значение, выбранное по умолчанию
См. также:: setInitialSelectionValue(java.lang.Object), setSelectionValues(java.lang.Object[])

setInputValue

public void setInputValue(Object newValue)

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

Параметры:: newValue — Object для установки значения, указанного пользователем (обычно в поле ввода текста)
См. также:: setSelectionValues(java.lang.Object[]), setInitialSelectionValue(java.lang.Object), setWantsInput(boolean), getInputValue()

getInputValue

public Object getInputValue()

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

Возвращает:: значение, указанное пользователем, если это было одно из объектов, или String если это было значение, введенное в поле
См. также:: setSelectionValues(java.lang.Object[]), setWantsInput(boolean), setInputValue(java.lang.Object)

getMaxCharactersPerLineCount

public int getMaxCharactersPerLineCount()

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

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

setWantsInput

public void setWantsInput(boolean newValue)

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

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

См. также:: setSelectionValues(java.lang.Object[]), setInputValue(java.lang.Object)

getWantsInput

public boolean getWantsInput()

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

Возвращает:: true, если будет предоставлен компонент ввода
См. также:: setWantsInput(boolean)

selectInitialValue

public void selectInitialValue()

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

paramString

protected String paramString()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

© 1993, 2020, 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.