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

message

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

Object[]

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

Component

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

Icon

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

другие типы

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

messageType

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

ERROR_MESSAGE

INFORMATION_MESSAGE

WARNING_MESSAGE

QUESTION_MESSAGE

PLAIN_MESSAGE

optionType

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

DEFAULT_OPTION

YES_NO_OPTION

YES_NO_CANCEL_OPTION

OK_CANCEL_OPTION

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

options

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

Component

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

Icon

Создаётся JButton, для которого этот объект используется в качестве метки.

другой тип

Объект 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);

Отобразить информационную панель с вариантами «да/нет» и сообщением «choose one»:

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

Отобразить внутреннее информационное диалоговое окно с вариантами «да/нет/отмена», сообщением «please choose one» и заголовком «information»:

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

Отобразить предупреждающее диалоговое окно с кнопками OK и CANCEL, заголовком «Warning» и сообщением «Click OK to continue»:

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 в пакет java.beans добавлена поддержка долгосрочного хранения всех JavaBeans. См. XMLEncoder.

Начиная с версии:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`JOptionPane.AccessibleJOptionPane`	Этот класс реализует поддержку специальных возможностей для класса `JOptionPane`.

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

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

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

Конструктор	Описание
`JOptionPane()`	Создаёт `JOptionPane` с тестовым сообщением.
`JOptionPane(Object message)`	Создаёт экземпляр `JOptionPane` для отображения сообщения с типом «обычное сообщение» и параметрами по умолчанию, предоставляемыми пользовательским интерфейсом.
`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.

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

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

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

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

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

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

UNINITIALIZED_VALUE

public static final Object UNINITIALIZED_VALUE

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

DEFAULT_OPTION

public static final int DEFAULT_OPTION

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

См. также:

YES_NO_OPTION

public static final int YES_NO_OPTION

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

См. также:

YES_NO_CANCEL_OPTION

public static final int YES_NO_CANCEL_OPTION

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

См. также:

OK_CANCEL_OPTION

public static final int OK_CANCEL_OPTION

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

См. также:

YES_OPTION

public static final int YES_OPTION

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

См. также:

NO_OPTION

public static final int NO_OPTION

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

См. также:

CANCEL_OPTION

public static final int CANCEL_OPTION

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

См. также:

OK_OPTION

public static final int OK_OPTION

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

См. также:

CLOSED_OPTION

public static final int CLOSED_OPTION

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

См. также:

ERROR_MESSAGE

public static final int ERROR_MESSAGE

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

См. также:

INFORMATION_MESSAGE

public static final int INFORMATION_MESSAGE

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

См. также:

WARNING_MESSAGE

public static final int WARNING_MESSAGE

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

См. также:

QUESTION_MESSAGE

public static final int QUESTION_MESSAGE

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

См. также:

PLAIN_MESSAGE

public static final int PLAIN_MESSAGE

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

См. также:

ICON_PROPERTY

public static final String ICON_PROPERTY

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

См. также:

MESSAGE_PROPERTY

public static final String MESSAGE_PROPERTY

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

См. также:

VALUE_PROPERTY

public static final String VALUE_PROPERTY

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

См. также:

OPTIONS_PROPERTY

public static final String OPTIONS_PROPERTY

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

См. также:

INITIAL_VALUE_PROPERTY

public static final String INITIAL_VALUE_PROPERTY

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

См. также:

MESSAGE_TYPE_PROPERTY

public static final String MESSAGE_TYPE_PROPERTY

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

См. также:

OPTION_TYPE_PROPERTY

public static final String OPTION_TYPE_PROPERTY

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

См. также:

SELECTION_VALUES_PROPERTY

public static final String SELECTION_VALUES_PROPERTY

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

См. также:

INITIAL_SELECTION_VALUE_PROPERTY

public static final String INITIAL_SELECTION_VALUE_PROPERTY

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

См. также:

INPUT_VALUE_PROPERTY

public static final String INPUT_VALUE_PROPERTY

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

См. также:

WANTS_INPUT_PROPERTY

public static final String WANTS_INPUT_PROPERTY

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

См. также:

icon

protected transient Icon icon

Значок, используемый в панели.

message

protected transient Object message

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

options

protected transient Object[] options

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

initialValue

protected transient Object initialValue

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

messageType

protected int messageType

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

optionType

protected int optionType

Тип вариантов: DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION или OK_CANCEL_OPTION.

value

protected transient Object value

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

selectionValues

protected transient Object[] selectionValues

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

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

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

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

JOptionPane

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

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

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

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

showInputDialog

public static String showInputDialog(Object message) throws HeadlessException

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

Параметры:

message — Object для отображения

Возвращает:

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

Выбрасывает:

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

См. также:

showInputDialog

public static String showInputDialog(Object message, Object initialSelectionValue)

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

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

showInputDialog

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

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

Параметры:

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

message — Object для отображения

Возвращает:

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

Выбрасывает:

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

См. также:

showInputDialog

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

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

Параметры:: 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 — String для отображения в строке заголовка диалогового окна

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

Возвращает:

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

Выбрасывает:

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

См. также:

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

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

icon — изображение Icon для отображения

selectionValues — массив Objects, задающий возможные варианты выбора

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

Возвращает:

ввод пользователя или null, означающее, что пользователь отменил ввод

Выбрасывает:

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

См. также:

showMessageDialog

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

Выводит диалоговое окно с информационным сообщением и заголовком «Сообщение».

Параметры:

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

message — Object для отображения

Выбрасывает:

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

См. также:

showMessageDialog

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

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

Параметры:

message — Object для отображения

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

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

Выбрасывает:

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

См. также:

showMessageDialog

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

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

Параметры:

message — Object для отображения

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

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

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

Выбрасывает:

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

См. также:

showConfirmDialog

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

Открывает диалоговое окно с вариантами Yes, No и Cancel и заголовком Select an Option.

Параметры:

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

message — Object для отображения

Возвращает:

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

Вызывает исключение:

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

См. также:

showConfirmDialog

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

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

Параметры:

message — Object для отображения

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

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

Возвращает:

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

Вызывает исключение:

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

См. также:

showConfirmDialog

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

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

Параметры:

message — Object для отображения

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

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

Возвращает:

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

Вызывает исключение:

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

См. также:

showConfirmDialog

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

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

Параметры:

message — объект для отображения

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

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

Возвращает:

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

Вызывает исключение:

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

См. также:

showOptionDialog

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

Открывает диалоговое окно с заданным значком; исходный вариант определяется параметром initialValue, а количество вариантов — параметром optionType.

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

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

Параметры:

message — Object для отображения

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

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

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

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

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

Возвращает:

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

Вызывает исключение:

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

См. также:

createDialog

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

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

Параметры:

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

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

Возвращает:

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

Вызывает исключение:

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

См. также:

createDialog

public JDialog createDialog(String title) throws HeadlessException

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

Параметры:

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

Возвращает:

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

Вызывает исключение:

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

Начиная с версии:

1.6

См. также:

showInternalMessageDialog

public static void showInternalMessageDialog(Component parentComponent, Object message)

Открывает внутреннюю панель подтверждения. Это диалоговое окно с информационным сообщением и заголовком «Message».

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

showInternalMessageDialog

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

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

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

showInternalMessageDialog

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

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

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

showInternalConfirmDialog

public static int showInternalConfirmDialog(Component parentComponent, Object message)

Открывает внутреннюю панель диалога с вариантами Yes, No и Cancel и заголовком Select an Option.

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

showInternalConfirmDialog

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

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

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

showInternalConfirmDialog

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

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

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

showInternalConfirmDialog

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

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

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

showInternalOptionDialog

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

Открывает внутреннюю панель диалога с заданным значком; исходный вариант определяется параметром initialValue, а количество вариантов — параметром optionType.

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

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

showInternalInputDialog

public static String showInternalInputDialog(Component parentComponent, Object message)

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

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

showInternalInputDialog

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

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

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

showInternalInputDialog

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

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

Параметры:: 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

См. также:

getDesktopPaneForComponent

public static JDesktopPane getDesktopPaneForComponent(Component parentComponent)

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

Параметры:: parentComponent — Component, для которого нужно найти панель рабочего стола
Возвращает:: JDesktopPane, содержащую компонент, или 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

См. также:

setUI

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

Задаёт объект UI, реализующий стиль оформления (L&F) этого компонента.

Параметры:

ui — объект OptionPaneUI стиля оформления (L&F)

См. также:

getUI

public OptionPaneUI getUI()

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

Переопределяет:: getUI в классе JComponent
Возвращает:: объект OptionPaneUI

updateUI

public void updateUI()

Уведомление от UIManager об изменении внешнего вида. Заменяет текущий объект UI последней версией из UIManager.

Переопределяет:

updateUI в классе JComponent

См. также:

getUIClassID

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

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

Переопределяет:

getUIClassID в классе JComponent

Возвращает:

строку "OptionPaneUI"

См. также:

setMessage

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

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

Параметры:

newMessage — Object для отображения

См. также:

getMessage

public Object getMessage()

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

Возвращает:

отображаемое значение Object

См. также:

setIcon

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

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

Параметры:

newIcon — Icon для отображения

См. также:

getIcon

public Icon getIcon()

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

Возвращает:

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

См. также:

setValue

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

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

Параметры:

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

См. также:

getValue

public Object getValue()

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

Возвращает:

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

См. также:

setOptions

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

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

Параметры:

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

См. также:

getOptions

public Object[] getOptions()

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

Возвращает:

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

См. также:

setInitialValue

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

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

Параметры:

newInitialValue — Object, на котором будет установлен исходный фокус клавиатуры

См. также:

getInitialValue

public Object getInitialValue()

Возвращает исходное значение.

Возвращает:

Object, на котором будет установлен исходный фокус клавиатуры

См. также:

setMessageType

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

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

Параметры:

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

Исключения:

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

См. также:

getMessageType

public int getMessageType()

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

Возвращает:

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

См. также:

setOptionType

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

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

Параметры:

newType — целое число, задающее варианты, которые должен отображать внешний вид: DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION или OK_CANCEL_OPTION

Исключения:

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

См. также:

getOptionType

public int getOptionType()

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

Возвращает:

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

См. также:

setSelectionValues

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

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

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

Параметры:

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

См. также:

getSelectionValues

public Object[] getSelectionValues()

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

Возвращает:

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

См. также:

setInitialSelectionValue

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

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

Параметры:

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

См. также:

getInitialSelectionValue

public Object getInitialSelectionValue()

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

Возвращает:

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

См. также:

setInputValue

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

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

Параметры:

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

См. также:

getInputValue

public Object getInputValue()

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

Возвращает:

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

См. также:

getMaxCharactersPerLineCount

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

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

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

setWantsInput

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

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

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

Параметры:

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

См. также:

getWantsInput

public boolean getWantsInput()

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

Возвращает:

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

См. также:

selectInitialValue

public void selectInitialValue()

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

paramString

protected String paramString()

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

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

getAccessibleContext

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

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

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

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