Spec-Zone.ru › OpenJDK 27

Класс JOptionPane

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
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 см. в разделе How to Make Dialogs руководства The Java Tutorial.

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

Распространенные имена методов JOptionPane и их описания
Имя метода Описание
showConfirmDialog Задает вопрос для подтверждения, например да/нет/отмена.
showInputDialog Запрашивает ввод данных.
showMessageDialog Сообщает пользователю о произошедшем событии.
showOptionDialog Универсальное объединение трех вышеперечисленных методов.
Каждый из этих методов также доступен в варианте showInternalXXX, который использует внутренний фрейм для размещения диалогового окна (см. JInternalFrame). Также определено множество вспомогательных методов — перегруженных версий основных методов, использующих различные списки параметров.

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

Стандартное диалоговое окно
значок сообщение
введенное значение
кнопки выбора
Базовый внешний вид таких диалоговых окон в целом похож на изображение выше, хотя за окончательный результат отвечают различные стили оформления (look-and-feel). В частности, стиль оформления настраивает компоновку с учетом свойства ComponentOrientation панели параметров.

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

parentComponent
Определяет Component, который будет родительским для этого диалогового окна. Он используется двумя способами: содержащий его Frame используется в качестве родительского Frame для диалогового окна, а его экранные координаты используются при размещении диалогового окна. Как правило, диалоговое окно размещается непосредственно под компонентом. Этот параметр может быть равен null; в этом случае в качестве родителя используется Frame по умолчанию, а диалоговое окно центрируется на экране (в зависимости от L&F).
message
Описательное сообщение, помещаемое в диалоговое окно. Чаще всего сообщение представляет собой просто String или константу String. Однако фактическим типом этого параметра является Object. Его интерпретация зависит от его типа:
Object[]
Массив объектов интерпретируется как серия сообщений (по одному на объект), расположенных вертикально. Интерпретация является рекурсивной — каждый объект в массиве интерпретируется в соответствии со своим типом.
Component
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);
Отображение информационной панели с вариантами yes/no и сообщением 'choose one':
JOptionPane.showConfirmDialog(null,
            "choose one", "choose one", JOptionPane.YES_NO_OPTION);
Отображение внутреннего информационного диалогового окна с вариантами yes/no/cancel, сообщением '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's Threading Policy.

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

Начиная с:
1.2
См. также:
  • JInternalFrame

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

Модификатор и тип Класс Описание
protected class  JOptionPane.AccessibleJOptionPane
Этот класс реализует поддержку доступности для класса JOptionPane.

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

JComponent.AccessibleJComponent
Модификатор и тип Класс Описание
class  JComponent.AccessibleJComponent
Внутренний класс JComponent, используемый для обеспечения стандартной поддержки доступности.

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

Container.AccessibleAWTContainer
Модификатор и тип Класс Описание
protected class  Container.AccessibleAWTContainer
Внутренний класс Container, используемый для обеспечения стандартной поддержки доступности.

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Модификатор и тип Класс Описание
protected class  Component.AccessibleAWTComponent
Внутренний класс Component, используемый для обеспечения стандартной поддержки доступности.
static enum  Component.BaselineResizeBehavior
Перечисление типичных способов изменения базовой линии компонента при изменении его размера.
protected class  Component.BltBufferStrategy
Внутренний класс для побитового копирования закадровых поверхностей на компонент.
protected class  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
Модификатор и тип Поле Описание
protected EventListenerList listenerList
Список слушателей событий для этого компонента.
static final String TOOL_TIP_TEXT_KEY
Комментарий, отображаемый при наведении курсора на компонент, также известный как «всплывающая подсказка» (value tip, flyover help или flyover label).
protected ComponentUI ui
Делегат внешнего вида (look and feel) для этого компонента.
static final int UNDEFINED_CONDITION
Константа, используемая некоторыми API для обозначения того, что условие не определено.
static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда принимающий компонент является предком компонента, находящегося в фокусе, или сам находится в фокусе.
static final int WHEN_FOCUSED
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда компонент находится в фокусе.
static final int WHEN_IN_FOCUSED_WINDOW
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда принимающий компонент находится в окне, имеющем фокус, или сам находится в фокусе.

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Модификатор и тип Поле Описание
protected AccessibleContext accessibleContext
AccessibleContext, связанный с этим Component.
static final float BOTTOM_ALIGNMENT
Удобная константа для getAlignmentY.
static final float CENTER_ALIGNMENT
Удобная константа для getAlignmentY и getAlignmentX.
static final float LEFT_ALIGNMENT
Удобная константа для getAlignmentX.
static final float RIGHT_ALIGNMENT
Удобная константа для getAlignmentX.
static final float TOP_ALIGNMENT
Удобная константа для getAlignmentY().

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

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Модификатор и тип Поле Описание
static final int ABORT
Этот флаг в аргументе infoflags метода imageUpdate указывает, что асинхронно отслеживаемое изображение было прервано до завершения генерации.
static final int ALLBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что статическое изображение, которое ранее отрисовывалось, теперь полностью готово и может быть отрисовано снова в окончательном виде.
static final int ERROR
Этот флаг в аргументе infoflags метода imageUpdate указывает, что при асинхронном отслеживании изображения произошла ошибка.
static final int FRAMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что стал доступен для повторной отрисовки очередной полный кадр ранее рисовавшегося многокадрового изображения.
static final int HEIGHT
Этот флаг в аргументе infoflags метода imageUpdate указывает, что высота базового изображения теперь доступна и может быть получена из аргумента height метода обратного вызова imageUpdate.
static final int PROPERTIES
Этот флаг в аргументе infoflags метода imageUpdate указывает, что свойства изображения стали доступны.
static final int SOMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что стали доступны дополнительные пиксели, необходимые для отрисовки масштабированного варианта изображения.
static final int WIDTH
Этот флаг в аргументе infoflags метода imageUpdate указывает, что ширина базового изображения теперь доступна и может быть получена из аргумента width метода обратного вызова imageUpdate.

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

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

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

Модификатор и тип Метод Описание
JDialog createDialog(Component parentComponent, String title)
Создает и возвращает новый JDialog, оборачивающий this, отцентрированный относительно parentComponent во фрейме parentComponent.
JDialog createDialog(String title)
Создает и возвращает новый JDialog без родительского компонента с указанным заголовком.
JInternalFrame createInternalFrame(Component parentComponent, String title)
Создает и возвращает экземпляр JInternalFrame.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JOptionPane.
static JDesktopPane getDesktopPaneForComponent(Component parentComponent)
Возвращает панель рабочего стола (desktop pane) указанного компонента.
static Frame getFrameForComponent(Component parentComponent)
Возвращает Frame указанного компонента.
Icon getIcon()
Возвращает значок, отображаемый этой панелью.
Object getInitialSelectionValue()
Возвращает вводимое значение, которое отображается пользователю как изначально выбранное.
Object getInitialValue()
Возвращает начальное значение.
Object getInputValue()
Возвращает значение, введенное пользователем, если wantsInput равно true.
int getMaxCharactersPerLineCount()
Возвращает максимальное количество символов, размещаемых в одной строке сообщения.
Object getMessage()
Возвращает объект сообщения, отображаемый этой панелью.
int getMessageType()
Возвращает тип сообщения.
Object[] getOptions()
Возвращает варианты, из которых пользователь может выбирать.
int getOptionType()
Возвращает тип отображаемых параметров.
static Frame getRootFrame()
Возвращает Frame для использования в методах класса, в которых фрейм не передан.
Object[] getSelectionValues()
Возвращает значения для выбора ввода.
OptionPaneUI getUI()
Возвращает объект UI, реализующий L&F для этого компонента.
String getUIClassID()
Возвращает имя класса UI, реализующего L&F для этого компонента.
Object getValue()
Возвращает значение, выбранное пользователем.
boolean getWantsInput()
Возвращает значение свойства wantsInput.
protected String paramString()
Возвращает строковое представление этого JOptionPane.
void selectInitialValue()
Запрашивает выбор начального значения, что приведет к установке фокуса на начальное значение.
void setIcon(Icon newIcon)
Устанавливает значок для отображения.
void setInitialSelectionValue(Object newValue)
Устанавливает вводимое значение, которое изначально отображается пользователю как выбранное.
void setInitialValue(Object newInitialValue)
Устанавливает начальное активируемое значение — Component, имеющий фокус при первоначальном отображении панели.
void setInputValue(Object newValue)
Устанавливает вводимое значение, выбранное или введенное пользователем.
void setMessage(Object newMessage)
Устанавливает объект сообщения панели параметров.
void setMessageType(int newType)
Устанавливает тип сообщения панели параметров.
void setOptions(Object[] newOptions)
Устанавливает параметры, отображаемые этой панелью.
void setOptionType(int newType)
Устанавливает параметры для отображения.
static void setRootFrame(Frame newRootFrame)
Устанавливает фрейм для использования в методах класса, в которых фрейм не передан.
void setSelectionValues(Object[] newValues)
Задает значения для выбора ввода для панели, предоставляющей пользователю список элементов на выбор.
void setUI(OptionPaneUI ui)
Устанавливает объект UI, реализующий L&F для этого компонента.
void setValue(Object newValue)
Устанавливает значение, выбранное пользователем.
void setWantsInput(boolean newValue)
Устанавливает свойство wantsInput.
static int showConfirmDialog(Component parentComponent, Object message)
Отображает диалоговое окно с вариантами Yes, No и Cancel; с заголовком Select an Option.
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)
Отображает панель внутреннего диалогового окна с вариантами Yes, No и Cancel; с заголовком Select an Option.
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)
Отображает диалоговое окно с информационным сообщением и заголовком "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
Модификатор и тип Метод Описание
void addAncestorListener(AncestorListener listener)
Регистрирует listener для получения AncestorEvents, когда он или любой из его предков перемещается либо становится видимым или невидимым.
void addNotify()
Уведомляет этот компонент о том, что у него появился родительский компонент.
void addVetoableChangeListener(VetoableChangeListener listener)
Добавляет VetoableChangeListener в список слушателей.
void computeVisibleRect(Rectangle visibleRect)
Возвращает "видимый прямоугольник" компонента Component — пересечение видимых прямоугольников для этого компонента и всех его предков.
boolean contains(int x, int y)
Предоставляет делегату пользовательского интерфейса возможность определить точную форму этого компонента для обработки событий мыши.
JToolTip createToolTip()
Возвращает экземпляр JToolTip, который должен использоваться для отображения всплывающей подсказки.
void disable()
Устарело.
Начиная с версии JDK 1.1, заменено на java.awt.Component.setEnabled(boolean).
void enable()
Устарело.
Начиная с версии JDK 1.1, заменено на java.awt.Component.setEnabled(boolean).
void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
Поддержка уведомлений об изменениях связанных свойств типа boolean.
void firePropertyChange(String propertyName, int oldValue, int newValue)
Поддержка уведомлений об изменениях связанных свойств типа integer.
protected void fireVetoableChange(String propertyName, Object oldValue, Object newValue)
Поддерживает уведомления об изменениях свойств с ограничениями.
ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)
Возвращает объект, который будет выполнять действие, зарегистрированное для заданного нажатия клавиши.
final ActionMap getActionMap()
Возвращает ActionMap, используемый для определения того, какое Action следует вызвать для конкретной привязки KeyStroke.
float getAlignmentX()
Переопределяет Container.getAlignmentX для возврата выравнивания по горизонтали.
float getAlignmentY()
Переопределяет Container.getAlignmentY для возврата выравнивания по вертикали.
AncestorListener[] getAncestorListeners()
Возвращает массив всех слушателей предков, зарегистрированных для этого компонента.
boolean getAutoscrolls()
Возвращает свойство autoscrolls.
int getBaseline(int width, int height)
Возвращает базовую линию.
Component.BaselineResizeBehavior getBaselineResizeBehavior()
Возвращает перечисление, указывающее, как базовая линия компонента изменяется при изменении размера.
Border getBorder()
Возвращает границу этого компонента или null, если граница в данный момент не задана.
Rectangle getBounds(Rectangle rv)
Сохраняет границы этого компонента в "возвращаемое значение" rv и возвращает rv.
final Object getClientProperty(Object key)
Возвращает значение свойства с указанным ключом.
protected Graphics getComponentGraphics(Graphics g)
Возвращает графический объект, используемый для отрисовки этого компонента.
JPopupMenu getComponentPopupMenu()
Возвращает JPopupMenu, назначенный для этого компонента.
int getConditionForKeyStroke(KeyStroke aKeyStroke)
Возвращает условие, определяющее, происходит ли зарегистрированное действие в ответ на указанное нажатие клавиши.
int getDebugGraphicsOptions()
Возвращает состояние отладки графики.
static Locale getDefaultLocale()
Возвращает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании.
FontMetrics getFontMetrics(Font font)
Возвращает FontMetrics для указанного Font.
Graphics getGraphics()
Возвращает графический контекст этого компонента, позволяющий рисовать на компоненте.
int getHeight()
Возвращает текущую высоту этого компонента.
boolean getInheritsPopupMenu()
Возвращает true, если JPopupMenu должно наследоваться от родителя.
final InputMap getInputMap()
Возвращает InputMap, который используется, когда компонент имеет фокус.
final InputMap getInputMap(int condition)
Возвращает InputMap, который используется во время condition.
InputVerifier getInputVerifier()
Возвращает верификатор ввода для этого компонента.
Insets getInsets()
Если для этого компонента была задана граница, возвращает отступы границы; в противном случае вызывает super.getInsets.
Insets getInsets(Insets insets)
Возвращает объект Insets, содержащий значения отступов этого компонента.
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, зарегистрированных в данный момент как FooListener для этого JComponent.
Point getLocation(Point rv)
Сохраняет начало координат x,y этого компонента в "возвращаемое значение" rv и возвращает rv.
Dimension getMaximumSize()
Если максимальный размер был установлен в значение, отличное от null, просто возвращает его.
Dimension getMinimumSize()
Если минимальный размер был установлен в значение, отличное от null, просто возвращает его.
Component getNextFocusableComponent()
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy.
Point getPopupLocation(MouseEvent event)
Возвращает предпочтительное расположение для отображения всплывающего меню в системе координат этого компонента.
Dimension getPreferredSize()
Если preferredSize было установлено в значение, отличное от null, просто возвращает его.
KeyStroke[] getRegisteredKeyStrokes()
Возвращает KeyStrokes, которое будет инициировать зарегистрированные действия.
JRootPane getRootPane()
Возвращает предка JRootPane для этого компонента.
Dimension getSize(Dimension rv)
Сохраняет ширину/высоту этого компонента в "возвращаемое значение" rv и возвращает rv.
Point getToolTipLocation(MouseEvent event)
Возвращает расположение всплывающей подсказки в системе координат этого компонента.
String getToolTipText()
Возвращает строку всплывающей подсказки, заданную с помощью setToolTipText.
String getToolTipText(MouseEvent event)
Возвращает строку, используемую в качестве всплывающей подсказки для event.
Container getTopLevelAncestor()
Возвращает предка верхнего уровня для этого компонента (содержащий Window) или null, если этот компонент не был добавлен ни в один контейнер.
TransferHandler getTransferHandler()
Возвращает свойство transferHandler.
boolean getVerifyInputWhenFocusTarget()
Возвращает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса перед тем, как этот компонент запросит фокус.
VetoableChangeListener[] getVetoableChangeListeners()
Возвращает массив всех слушателей вето-изменений, зарегистрированных для этого компонента.
Rectangle getVisibleRect()
Возвращает "видимый прямоугольник" компонента Component — пересечение видимого прямоугольника этого компонента, new Rectangle(0, 0, getWidth(), getHeight()), и видимых прямоугольников всех его предков.
int getWidth()
Возвращает текущую ширину этого компонента.
int getX()
Возвращает текущую координату x начала этого компонента.
int getY()
Возвращает текущую координату y начала этого компонента.
void grabFocus()
Запрашивает передачу фокуса ввода этому Component и установку предка верхнего уровня этого Component в качестве сфокусированного Window.
void hide()
Устарело.
boolean isDoubleBuffered()
Возвращает значение, указывающее, должен ли этот компонент использовать буфер для отрисовки.
static boolean isLightweightComponent(Component c)
Возвращает true, если этот компонент является легковесным, то есть если у него нет нативного аналога в оконной системе.
boolean isManagingFocus()
Устарело.
Начиная с версии 1.4, заменено на Component.setFocusTraversalKeys(int, Set) и Container.setFocusCycleRoot(boolean).
boolean isOpaque()
Возвращает true, если этот компонент полностью непрозрачен.
boolean isOptimizedDrawingEnabled()
Возвращает true, если этот компонент размещает свои дочерние элементы мозаикой — то есть если он может гарантировать, что дочерние элементы не будут перекрываться.
final boolean isPaintingForPrint()
Возвращает true, если текущая операция отрисовки для этого компонента является частью операции print.
protected boolean isPaintingOrigin()
Возвращает true, если отрисовка, вызванная на дочернем компоненте, должна приводить к запуску отрисовки из этого Component или одного из его предков.
boolean isPaintingTile()
Возвращает true, если компонент в данный момент отрисовывает тайл.
boolean isRequestFocusEnabled()
Возвращает true, если этот JComponent должен получить фокус; в противном случае возвращает false.
boolean isValidateRoot()
Если этот метод возвращает true, вызовы revalidate потомками этого компонента приведут к валидации всего дерева, начиная с этого корня.
void paint(Graphics g)
Вызывается Swing для отрисовки компонентов.
protected void paintBorder(Graphics g)
Отрисовывает границу компонента.
protected void paintChildren(Graphics g)
Отрисовывает дочерние элементы этого компонента.
protected void paintComponent(Graphics g)
Вызывает метод отрисовки делегата UI, если делегат UI не равен null.
void paintImmediately(int x, int y, int w, int h)
Немедленно отрисовывает указанную область в этом компоненте и всех его потомках, перекрывающих эту область.
void paintImmediately(Rectangle r)
Отрисовывает указанную область немедленно.
void print(Graphics g)
Вызовите этот метод для печати компонента в указанный Graphics.
void printAll(Graphics g)
Вызовите этот метод для печати компонента.
protected void printBorder(Graphics g)
Печатает границу компонента.
protected void printChildren(Graphics g)
Печатает дочерние элементы этого компонента.
protected void printComponent(Graphics g)
Вызывается во время операции печати.
protected void processComponentKeyEvent(KeyEvent e)
Обрабатывает любые события клавиатуры, которые распознает сам компонент.
protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
Вызывается для обработки привязок клавиш для ks в результате KeyEvent e.
protected void processKeyEvent(KeyEvent e)
Переопределяет processKeyEvent для обработки событий.
protected void processMouseEvent(MouseEvent e)
Обрабатывает события мыши, происходящие в этом компоненте, путем их диспетчеризации любым зарегистрированным объектам MouseListener; полное описание этого метода см. в Component.processMouseEvent(MouseEvent).
protected void processMouseMotionEvent(MouseEvent e)
Обрабатывает события движения мыши, такие как MouseEvent.MOUSE_DRAGGED.
final void putClientProperty(Object key, Object value)
Добавляет произвольное "клиентское свойство" типа ключ/значение к этому компоненту.
void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел; для аналогичного поведения используйте комбинацию getActionMap() и getInputMap().
void registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел; для аналогичного поведения используйте комбинацию getActionMap() и getInputMap().
void removeAncestorListener(AncestorListener listener)
Отменяет регистрацию listener, чтобы он больше не получал AncestorEvents.
void removeNotify()
Уведомляет этот компонент о том, что у него больше нет родительского компонента.
void removeVetoableChangeListener(VetoableChangeListener listener)
Удаляет VetoableChangeListener из списка слушателей.
void repaint(long tm, int x, int y, int width, int height)
Добавляет указанную область в список "грязных" областей, если компонент отображается.
void repaint(Rectangle r)
Добавляет указанную область в список "грязных" областей, если компонент отображается.
boolean requestDefaultFocus()
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
void requestFocus()
Запрашивает передачу фокуса ввода этому Component.
boolean requestFocus(boolean temporary)
Запрашивает передачу фокуса ввода этому Component.
boolean requestFocusInWindow()
Запрашивает передачу фокуса ввода этому Component.
protected boolean requestFocusInWindow(boolean temporary)
Запрашивает передачу фокуса ввода этому Component.
void resetKeyboardActions()
Отменяет регистрацию всех привязок в первом уровне InputMaps и ActionMap.
void reshape(int x, int y, int w, int h)
Устарело.
Начиная с версии JDK 5, заменено на Component.setBounds(int, int, int, int).
void revalidate()
Поддерживает отложенную автоматическую компоновку.
void scrollRectToVisible(Rectangle aRect)
Пересылает сообщение scrollRectToVisible() родителю JComponent.
final void setActionMap(ActionMap am)
Устанавливает ActionMap в am.
void setAlignmentX(float alignmentX)
Задает выравнивание по горизонтали.
void setAlignmentY(float alignmentY)
Задает выравнивание по вертикали.
void setAutoscrolls(boolean autoscrolls)
Задает свойство autoscrolls.
void setBackground(Color bg)
Задает цвет фона этого компонента.
void setBorder(Border border)
Задает границу этого компонента.
void setComponentPopupMenu(JPopupMenu popup)
Задает JPopupMenu для этого JComponent.
void setDebugGraphicsOptions(int debugOptions)
Включает или отключает диагностическую информацию о каждой графической операции, выполняемой внутри компонента или одного из его дочерних элементов.
static void setDefaultLocale(Locale l)
Задает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании.
void setDoubleBuffered(boolean aFlag)
Устанавливает, должен ли этот компонент использовать буфер для отрисовки.
void setEnabled(boolean enabled)
Задает доступность компонента (включен или выключен).
void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Задает клавиши обхода фокуса для заданной операции перемещения фокуса для этого Component.
void setFont(Font font)
Задает шрифт для этого компонента.
void setForeground(Color fg)
Задает цвет переднего плана этого компонента.
void setInheritsPopupMenu(boolean value)
Устанавливает, должен ли getComponentPopupMenu делегировать родителю, если для этого компонента не назначен JPopupMenu.
final void setInputMap(int condition, InputMap map)
Задает InputMap для использования при условии condition в map.
void setInputVerifier(InputVerifier inputVerifier)
Задает верификатор ввода для этого компонента.
void setMaximumSize(Dimension maximumSize)
Задает максимальный размер этого компонента в виде постоянного значения.
void setMinimumSize(Dimension minimumSize)
Задает минимальный размер этого компонента в виде постоянного значения.
void setNextFocusableComponent(Component aComponent)
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy
void setOpaque(boolean isOpaque)
Если true, компонент отрисовывает каждый пиксель в пределах своих границ.
void setPreferredSize(Dimension preferredSize)
Задает предпочтительный размер этого компонента.
void setRequestFocusEnabled(boolean requestFocusEnabled)
Предоставляет подсказку относительно того, должен ли этот JComponent получать фокус.
void setToolTipText(String text)
Регистрирует текст для отображения во всплывающей подсказке.
void setTransferHandler(TransferHandler newHandler)
Задает TransferHandler, обеспечивающий поддержку передачи данных в этот компонент и из него с помощью вырезания/копирования/вставки и перетаскивания.
protected void setUI(ComponentUI newUI)
Задает делегат внешнего вида и поведения для этого компонента.
void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)
Задает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса перед тем, как этот компонент запросит фокус.
void setVisible(boolean aFlag)
Делает компонент видимым или невидимым.
void unregisterKeyboardAction(KeyStroke aKeyStroke)
Этот метод устарел.
void update(Graphics g)
Вызывает paint.

Методы, объявленные в классе 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 add(Component comp)
Добавляет указанный компонент в конец этого контейнера.
Component add(Component comp, int index)
Добавляет указанный компонент в этот контейнер на заданную позицию.
void add(Component comp, Object constraints)
Добавляет указанный компонент в конец этого контейнера.
void add(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер с заданными ограничениями по указанному индексу.
Component add(String name, Component comp)
Добавляет указанный компонент в этот контейнер.
void addContainerListener(ContainerListener l)
Добавляет указанный слушатель контейнера для получения событий контейнера от этого контейнера.
protected void addImpl(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер по указанному индексу.
void addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener в список слушателей.
void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Добавляет PropertyChangeListener в список слушателей для определенного свойства.
void applyComponentOrientation(ComponentOrientation o)
Устанавливает свойство ComponentOrientation этого контейнера и всех компонентов, содержащихся внутри него.
boolean areFocusTraversalKeysSet(int id)
Возвращает значение, указывающее, был ли явно определен для этого контейнера набор клавиш обхода фокуса для заданной операции обхода фокуса.
int countComponents()
Устарело.
Начиная с версии JDK 1.1, заменено на getComponentCount().
void deliverEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent e)
void doLayout()
Заставляет этот контейнер разместить свои компоненты.
Component findComponentAt(int x, int y)
Находит видимый дочерний компонент, содержащий указанную позицию.
Component findComponentAt(Point p)
Находит видимый дочерний компонент, содержащий указанную точку.
Component getComponent(int n)
Возвращает n-й компонент в этом контейнере.
Component getComponentAt(int x, int y)
Находит компонент, содержащий позицию x,y.
Component getComponentAt(Point p)
Возвращает компонент, содержащий указанную точку.
int getComponentCount()
Возвращает количество компонентов в этой панели.
Component[] getComponents()
Возвращает все компоненты в этом контейнере.
int getComponentZOrder(Component comp)
Возвращает индекс z-порядка компонента внутри контейнера.
ContainerListener[] getContainerListeners()
Возвращает массив всех слушателей контейнера, зарегистрированных для этого контейнера.
Set<AWTKeyStroke> getFocusTraversalKeys(int id)
Возвращает набор клавиш обхода фокуса для заданной операции обхода для этого контейнера.
FocusTraversalPolicy getFocusTraversalPolicy()
Возвращает политику обхода фокуса, которая будет управлять обходом с клавиатуры дочерних элементов этого контейнера, или null, если этот контейнер не является корнем цикла фокуса.
LayoutManager getLayout()
Возвращает менеджер компоновки для этого контейнера.
Point getMousePosition(boolean allowChildren)
Возвращает положение указателя мыши в системе координат этого Container, если Container находится под указателем мыши, в противном случае возвращает null.
Insets insets()
Устарело.
Начиная с версии JDK 1.1, заменено на getInsets().
void invalidate()
Делает контейнер недействительным.
boolean isAncestorOf(Component c)
Проверяет, содержится ли компонент в иерархии компонентов этого контейнера.
boolean isFocusCycleRoot()
Возвращает значение, указывающее, является ли этот контейнер корнем цикла обхода фокуса.
boolean isFocusCycleRoot(Container container)
Возвращает значение, указывающее, является ли указанный контейнер корнем цикла фокуса для цикла обхода фокуса этого контейнера.
final boolean isFocusTraversalPolicyProvider()
Возвращает значение, указывающее, предоставляет ли этот контейнер политику обхода фокуса.
boolean isFocusTraversalPolicySet()
Возвращает значение, указывающее, была ли политика обхода фокуса явно задана для этого контейнера.
void layout()
Устарело.
Начиная с версии JDK 1.1, заменено на doLayout().
void list(PrintStream out, int indent)
Выводит список содержимого этого контейнера в указанный выходной поток.
void list(PrintWriter out, int indent)
Выводит список, начиная с указанного отступа, в указанный print writer.
Component locate(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на getComponentAt(int, int).
Dimension minimumSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getMinimumSize().
paintComponents(Graphics g) void
Отрисовывает каждый из компонентов в этом контейнере.
Dimension preferredSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getPreferredSize().
void printComponents(Graphics g)
Печатает каждый из компонентов в этом контейнере.
protected void processContainerEvent(ContainerEvent e)
Обрабатывает события контейнера, происходящие в этом контейнере, отправляя их любым зарегистрированным объектам ContainerListener.
protected void processEvent(AWTEvent e)
Обрабатывает события в этом контейнере.
void remove(int index)
Удаляет компонент, указанный с помощью index, из этого контейнера.
void remove(Component comp)
Удаляет указанный компонент из этого контейнера.
void removeAll()
Удаляет все компоненты из этого контейнера.
void removeContainerListener(ContainerListener l)
Удаляет указанный слушатель контейнера, чтобы он больше не получал события контейнера от этого контейнера.
void setComponentZOrder(Component comp, int index)
Перемещает указанный компонент на указанный индекс z-порядка в контейнере.
void setFocusCycleRoot(boolean focusCycleRoot)
Задает, является ли этот контейнер корнем цикла обхода фокуса.
void setFocusTraversalPolicy(FocusTraversalPolicy policy)
Устанавливает политику обхода фокуса, которая будет управлять обходом с клавиатуры дочерних элементов этого контейнера, если этот контейнер является корнем цикла фокуса.
final void setFocusTraversalPolicyProvider(boolean provider)
Задает, будет ли этот контейнер использоваться для предоставления политики обхода фокуса.
void setLayout(LayoutManager mgr)
Устанавливает менеджер компоновки для этого контейнера.
void transferFocusDownCycle()
Передает фокус на один цикл обхода фокуса вниз.
void validate()
Проверяет корректность (validates) этого контейнера и всех его подкомпонентов.
protected void 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
Модификатор и тип Метод Описание
boolean action(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, этот компонент следует регистрировать в качестве ActionListener на компоненте, который инициирует события действия.
void add(PopupMenu popup)
Добавляет указанное всплывающее меню в этот компонент.
void addComponentListener(ComponentListener l)
Добавляет указанный слушатель компонентов для получения событий компонента от этого компонента.
void addFocusListener(FocusListener l)
Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента, когда этот компонент получает фокус ввода.
void addHierarchyBoundsListener(HierarchyBoundsListener l)
Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
void addHierarchyListener(HierarchyListener l)
Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
void addInputMethodListener(InputMethodListener l)
Добавляет указанный слушатель методов ввода для получения событий метода ввода от этого компонента.
void addKeyListener(KeyListener l)
Добавляет указанный слушатель клавиатуры для получения событий клавиатуры от этого компонента.
void addMouseListener(MouseListener l)
Добавляет указанный слушатель мыши для получения событий мыши от этого компонента.
void addMouseMotionListener(MouseMotionListener l)
Добавляет указанный слушатель перемещения мыши для получения событий перемещения мыши от этого компонента.
void addMouseWheelListener(MouseWheelListener l)
Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента.
Rectangle bounds()
Устарело.
Начиная с версии JDK 1.1, заменено на getBounds().
int checkImage(Image image, int width, int height, ImageObserver observer)
Возвращает статус построения экранного представления указанного изображения.
int checkImage(Image image, ImageObserver observer)
Возвращает статус построения экранного представления указанного изображения.
protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)
Потенциально объединяет отправляемое событие с существующим событием.
boolean contains(Point p)
Проверяет, «содержит» ли этот компонент указанную точку, где координаты точки x и y определены относительно системы координат этого компонента.
Image createImage(int width, int height)
Создает закадровое отрисовываемое изображение для использования при двойной буферизации.
Image createImage(ImageProducer producer)
Создает изображение из указанного поставщика изображений.
VolatileImage createVolatileImage(int width, int height)
Создает изменяемое (volatile) закадровое отрисовываемое изображение для использования при двойной буферизации.
VolatileImage createVolatileImage(int width, int height, ImageCapabilities caps)
Создает изменяемое (volatile) закадровое отрисовываемое изображение с заданными возможностями.
protected final void disableEvents(long eventsToDisable)
Отключает доставку событий, определенных указанным параметром маски событий, в этот компонент.
final void dispatchEvent(AWTEvent e)
Диспетчеризирует событие этому компоненту или одному из его подкомпонентов.
void enable(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setEnabled(boolean).
protected final void enableEvents(long eventsToEnable)
Включает доставку событий, определенных указанным параметром маски событий, в этот компонент.
void enableInputMethods(boolean enable)
Включает или отключает поддержку методов ввода для этого компонента.
void firePropertyChange(String propertyName, byte oldValue, byte newValue)
Сообщает об изменении связанного свойства (bound property).
void firePropertyChange(String propertyName, char oldValue, char newValue)
Сообщает об изменении связанного свойства (bound property).
void firePropertyChange(String propertyName, double oldValue, double newValue)
Сообщает об изменении связанного свойства (bound property).
void firePropertyChange(String propertyName, float oldValue, float newValue)
Сообщает об изменении связанного свойства (bound property).
void firePropertyChange(String propertyName, long oldValue, long newValue)
Сообщает об изменении связанного свойства (bound property).
void firePropertyChange(String propertyName, short oldValue, short newValue)
Сообщает об изменении связанного свойства (bound property).
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
Поддержка оповещения об изменениях связанных свойств для свойств типа Object.
Color getBackground()
Возвращает цвет фона этого компонента.
Rectangle getBounds()
Возвращает границы этого компонента в виде объекта Rectangle.
ColorModel getColorModel()
Возвращает экземпляр ColorModel, используемый для отображения компонента на устройстве вывода.
ComponentListener[] getComponentListeners()
Возвращает массив всех слушателей компонентов, зарегистрированных для этого компонента.
ComponentOrientation getComponentOrientation()
Возвращает зависящую от языка ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
Cursor getCursor()
Возвращает курсор, установленный в компоненте.
DropTarget getDropTarget()
Возвращает DropTarget, связанный с этим Component.
Container getFocusCycleRootAncestor()
Возвращает контейнер, который является корнем цикла фокусировки для цикла обхода фокуса этого компонента.
FocusListener[] getFocusListeners()
Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
boolean getFocusTraversalKeysEnabled()
Возвращает значение, указывающее, включены ли клавиши обхода фокуса для этого компонента.
Font getFont()
Возвращает шрифт этого компонента.
Color getForeground()
Возвращает цвет переднего плана этого компонента.
GraphicsConfiguration getGraphicsConfiguration()
Возвращает GraphicsConfiguration, связанный с этим Component.
HierarchyBoundsListener[] getHierarchyBoundsListeners()
Возвращает массив всех слушателей границ иерархии, зарегистрированных для этого компонента.
HierarchyListener[] getHierarchyListeners()
Возвращает массив всех слушателей иерархии, зарегистрированных для этого компонента.
boolean getIgnoreRepaint()
Возвращает значение, указывающее, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
InputContext getInputContext()
Возвращает контекст ввода, используемый этим компонентом для обработки взаимодействия с методами ввода при вводе текста в этом компоненте.
InputMethodListener[] getInputMethodListeners()
Возвращает массив всех слушателей методов ввода, зарегистрированных для этого компонента.
InputMethodRequests getInputMethodRequests()
Возвращает обработчик запросов метода ввода, поддерживающий запросы от методов ввода для этого компонента.
KeyListener[] getKeyListeners()
Возвращает массив всех слушателей клавиатуры, зарегистрированных для этого компонента.
Locale getLocale()
Возвращает локаль этого компонента.
Point getLocation()
Возвращает положение этого компонента в виде точки, определяющей его левый верхний угол.
Point getLocationOnScreen()
Возвращает положение этого компонента в виде точки, определяющей его левый верхний угол в пространстве координат экрана.
MouseListener[] getMouseListeners()
Возвращает массив всех слушателей мыши, зарегистрированных для этого компонента.
MouseMotionListener[] getMouseMotionListeners()
Возвращает массив всех слушателей перемещения мыши, зарегистрированных для этого компонента.
Point getMousePosition()
Возвращает позицию указателя мыши в координатном пространстве этого Component, если Component находится непосредственно под указателем мыши, в противном случае возвращает null.
MouseWheelListener[] getMouseWheelListeners()
Возвращает массив всех слушателей колесика мыши, зарегистрированных для этого компонента.
String getName()
Возвращает имя компонента.
Container getParent()
Возвращает родительский элемент этого компонента.
PropertyChangeListener[] getPropertyChangeListeners()
Возвращает массив всех слушателей изменений свойств, зарегистрированных для этого компонента.
PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
Возвращает массив всех слушателей, связанных с именованным свойством.
Dimension getSize()
Возвращает размер этого компонента в виде объекта Dimension.
Toolkit getToolkit()
Возвращает инструментарий (toolkit) этого компонента.
final Object getTreeLock()
Возвращает объект блокировки этого компонента (объект, которому принадлежит монитор синхронизации потоков) для дерева компонентов AWT и операций компоновки.
boolean gotFocus(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
boolean handleEvent(Event evt)
Устарело.
Начиная с версии JDK 1.1, заменено на processEvent(AWTEvent).
boolean hasFocus()
Возвращает true, если этот Component является владельцем фокуса.
boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Перерисовывает компонент при изменении изображения.
boolean inside(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на contains(int, int).
boolean isBackgroundSet()
Возвращает значение, указывающее, был ли явно задан цвет фона для этого компонента.
boolean isCursorSet()
Возвращает значение, указывающее, был ли явно задан курсор для этого компонента.
boolean isDisplayable()
Определяет, является ли этот компонент отображаемым.
boolean isEnabled()
Определяет, включен ли этот компонент.
boolean isFocusable()
Возвращает значение, указывающее, может ли этот компонент получать фокус.
boolean isFocusOwner()
Возвращает true, если этот Component является владельцем фокуса.
boolean isFocusTraversable()
Устарело.
Начиная с версии 1.4, заменено на isFocusable().
boolean isFontSet()
Возвращает значение, указывающее, был ли явно задан шрифт для этого компонента.
boolean isForegroundSet()
Возвращает значение, указывающее, был ли явно задан цвет переднего плана для этого компонента.
boolean isLightweight()
Легковесный компонент не имеет собственного (native toolkit) пира.
boolean isMaximumSizeSet()
Возвращает true, если максимальный размер был установлен в значение, отличное от null; в противном случае возвращает false.
boolean isMinimumSizeSet()
Возвращает значение, указывающее, вызывался ли метод setMinimumSize со значением, отличным от null.
boolean isPreferredSizeSet()
Возвращает true, если предпочтительный размер был установлен в значение, отличное от null; в противном случае возвращает false.
boolean isShowing()
Определяет, отображается ли этот компонент на экране.
boolean isValid()
Определяет, является ли этот компонент корректным (valid).
boolean isVisible()
Определяет, должен ли этот компонент быть видимым, когда видим его родитель.
boolean keyDown(Event evt, int key)
Устарело.
Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
boolean keyUp(Event evt, int key)
Устарело.
Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
void list()
Выводит листинг этого компонента в стандартный системный поток вывода System.out.
void list(PrintStream out)
Выводит листинг этого компонента в указанный поток вывода.
void list(PrintWriter out)
Выводит листинг в указанный модуль записи (print writer).
Point location()
Устарело.
Начиная с версии JDK 1.1, заменено на getLocation().
boolean lostFocus(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
boolean mouseDown(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseDrag(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
boolean mouseEnter(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseExit(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseMove(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
boolean mouseUp(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
void move(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на setLocation(int, int).
void nextFocus()
Устарело.
Начиная с версии JDK 1.1, заменено на transferFocus().
void paintAll(Graphics g)
Отрисовывает этот компонент и все его подкомпоненты.
boolean postEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent).
boolean prepareImage(Image image, int width, int height, ImageObserver observer)
Подготавливает изображение для отрисовки на этом компоненте с указанными шириной и высотой.
boolean prepareImage(Image image, ImageObserver observer)
Подготавливает изображение для отрисовки на этом компоненте.
protected void processComponentEvent(ComponentEvent e)
Обрабатывает события компонента, происходящие в этом компоненте, путем диспетчеризации их любым зарегистрированным объектам ComponentListener.
protected void processFocusEvent(FocusEvent e)
Обрабатывает события фокуса, происходящие в этом компоненте, путем диспетчеризации их любым зарегистрированным объектам FocusListener.
protected void processHierarchyBoundsEvent(HierarchyEvent e)
Обрабатывает события границ иерархии, происходящие в этом компоненте, путем диспетчеризации их любым зарегистрированным объектам HierarchyBoundsListener.
protected void processHierarchyEvent(HierarchyEvent e)
Обрабатывает события иерархии, происходящие в этом компоненте, путем диспетчеризации их любым зарегистрированным объектам HierarchyListener.
protected void processInputMethodEvent(InputMethodEvent e)
Обрабатывает события метода ввода, происходящие в этом компоненте, путем диспетчеризации их любым зарегистрированным объектам InputMethodListener.
protected void processMouseWheelEvent(MouseWheelEvent e)
Обрабатывает события колесика мыши, происходящие в этом компоненте, путем диспетчеризации их любым зарегистрированным объектам MouseWheelListener.
void remove(MenuComponent popup)
Удаляет указанное всплывающее меню из компонента.
void removeComponentListener(ComponentListener l)
Удаляет указанный слушатель компонентов, чтобы он больше не получал события компонента от этого компонента.
void removeFocusListener(FocusListener l)
Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента.
void removeHierarchyBoundsListener(HierarchyBoundsListener l)
Удаляет указанный слушатель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
void removeHierarchyListener(HierarchyListener l)
Удаляет указанный слушатель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
void removeInputMethodListener(InputMethodListener l)
Удаляет указанный слушатель методов ввода, чтобы он больше не получал события методов ввода от этого компонента.
void removeKeyListener(KeyListener l)
Удаляет указанный слушатель клавиатуры, чтобы он больше не получал события клавиатуры от этого компонента.
void removeMouseListener(MouseListener l)
Удаляет указанный слушатель мыши, чтобы он больше не получал события мыши от этого компонента.
void removeMouseMotionListener(MouseMotionListener l)
Удаляет указанный слушатель перемещения мыши, чтобы он больше не получал события перемещения мыши от этого компонента.
void removeMouseWheelListener(MouseWheelListener l)
Удаляет указанный слушатель колесика мыши, чтобы он больше не получал события колесика мыши от этого компонента.
void removePropertyChangeListener(PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей.
void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей для определенного свойства.
void repaint()
Перерисовывает этот компонент.
void repaint(int x, int y, int width, int height)
Перерисовывает указанную прямоугольную область этого компонента.
void repaint(long tm)
Перерисовывает компонент.
protected boolean requestFocus(boolean temporary, FocusEvent.Cause cause)
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, а предок верхнего уровня этого Component стал сфокусированным Window.
void requestFocus(FocusEvent.Cause cause)
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, а предок верхнего уровня этого Component стал сфокусированным Window.
boolean requestFocusInWindow(FocusEvent.Cause cause)
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, если предок верхнего уровня этого Component уже является сфокусированным Window.
void resize(int width, int height)
Устарело.
Начиная с версии JDK 1.1, заменено на setSize(int, int).
void resize(Dimension d)
Устарело.
Начиная с версии JDK 1.1, заменено на setSize(Dimension).
void setBounds(int x, int y, int width, int height)
Перемещает и изменяет размер этого компонента.
void setBounds(Rectangle r)
Перемещает и изменяет размер этого компонента в соответствии с новым ограничивающим прямоугольником r.
void setComponentOrientation(ComponentOrientation o)
Устанавливает зависящую от языка ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
void setCursor(Cursor cursor)
Устанавливает изображение курсора в указанный курсор.
void setDropTarget(DropTarget dt)
Связывает DropTarget с этим компонентом.
void setFocusable(boolean focusable)
Устанавливает состояние фокусируемости этого Component в указанное значение.
void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)
Задает, включены ли клавиши обхода фокуса для этого Component.
void setIgnoreRepaint(boolean ignoreRepaint)
Задает, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
void setLocale(Locale l)
Устанавливает локаль этого компонента.
void setLocation(int x, int y)
Перемещает этот компонент на новое место.
void setLocation(Point p)
Перемещает этот компонент на новое место.
void setMixingCutoutShape(Shape shape)
Задает форму вырезания при смешивании («mixing-cutout») для этого легковесного компонента.
void setName(String name)
Устанавливает имя компонента в указанную строку.
void setSize(int width, int height)
Изменяет размер этого компонента так, чтобы он имел ширину width и высоту height.
void setSize(Dimension d)
Изменяет размер этого компонента так, чтобы он имел ширину d.width и высоту d.height.
void show()
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).
void show(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).
Dimension size()
Устарело.
Начиная с версии JDK 1.1, заменено на getSize().
String toString()
Возвращает строковое представление этого компонента и его значений.
void transferFocus()
Передает фокус следующему компоненту так, как если бы этот Component был владельцем фокуса.
void transferFocusBackward()
Передает фокус предыдущему компоненту так, как если бы этот Component был владельцем фокуса.
void transferFocusUpCycle()
Передает фокус на один цикл обхода фокуса вверх.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли другой объект «этому».
protected void finalize()
Устарело, для удаления: этот элемент API подлежит удалению в будущей версии.
Механизм финализации устарел и подлежит удалению в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс среды выполнения для этого Object.
int hashCode()
Возвращает значение хэш-кода для этого объекта.
final void notify()
Возобновляет работу одного потока, ожидающего монитора этого объекта.
final void notifyAll()
Возобновляет работу всех потоков, ожидающих монитора этого объекта.
final void wait()
Переводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно путем оповещения или прерывания.
final void wait(long timeoutMillis)
Переводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно путем оповещения или прерывания, либо пока не истечет определенное время.
final void wait(long timeoutMillis, int nanos)
Переводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно путем оповещения или прерывания, либо пока не истечет определенное время.

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

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
Имя связанного свойства (bound property) для icon.
См. также:
  • Значения константных полей

MESSAGE_PROPERTY

public static final String MESSAGE_PROPERTY
Имя связанного свойства (bound property) для message.
См. также:
  • Значения константных полей

VALUE_PROPERTY

public static final String VALUE_PROPERTY
Имя связанного свойства (bound property) для value.
См. также:
  • Значения константных полей

OPTIONS_PROPERTY

public static final String OPTIONS_PROPERTY
Имя связанного свойства (bound property) для option.
См. также:
  • Значения константных полей

INITIAL_VALUE_PROPERTY

public static final String INITIAL_VALUE_PROPERTY
Имя связанного свойства (bound property) для initialValue.
См. также:
  • Значения константных полей

MESSAGE_TYPE_PROPERTY

public static final String MESSAGE_TYPE_PROPERTY
Имя связанного свойства (bound property) для type.
См. также:
  • Значения константных полей

OPTION_TYPE_PROPERTY

public static final String OPTION_TYPE_PROPERTY
Имя связанного свойства (bound property) для optionType.
См. также:
  • Значения константных полей

SELECTION_VALUES_PROPERTY

public static final String SELECTION_VALUES_PROPERTY
Имя связанного свойства (bound property) для selectionValues.
См. также:
  • Значения константных полей

INITIAL_SELECTION_VALUE_PROPERTY

public static final String INITIAL_SELECTION_VALUE_PROPERTY
Имя связанного свойства (bound property) для initialSelectionValue.
См. также:
  • Значения константных полей

INPUT_VALUE_PROPERTY

public static final String INPUT_VALUE_PROPERTY
Имя связанного свойства (bound property) для inputValue.
См. также:
  • Значения константных полей

WANTS_INPUT_PROPERTY

public static final String WANTS_INPUT_PROPERTY
Имя связанного свойства (bound 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 для отображения сообщения с использованием типа сообщения 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 - изображение 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 - строка String для отображения в строке заголовка диалогового окна
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 - строка String для отображения в строке заголовка диалогового окна
messageType - тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE или PLAIN_MESSAGE
icon - изображение Icon для отображения
selectionValues - массив объектов Object, задающий возможные варианты выбора
initialSelectionValue - значение, используемое для инициализации поля ввода
Возвращает:
ввод пользователя или null, что означает, что пользователь отменил ввод
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:
  • GraphicsEnvironment.isHeadless()

showMessageDialog

public static void showMessageDialog(Component parentComponent, Object message) throws HeadlessException
Открывает диалоговое окно с информационным сообщением и заголовком "Message".
Параметры:
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
Отображает диалоговое окно с вариантами Да, Нет и Отмена; с заголовком Select an Option.
Параметры:
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 - целое число (int), определяющее доступные варианты в диалоговом окне: YES_NO_OPTION, YES_NO_CANCEL_OPTION или OK_CANCEL_OPTION
Возвращает:
целое число (int), указывающее на выбранный пользователем вариант
Исключения:
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 в основном используется для предоставления значка по умолчанию из Look and Feel.
Параметры:
parentComponent - определяет Frame, в котором отображается диалоговое окно; если null или если у parentComponent нет Frame, используется Frame по умолчанию.
message - Object для отображения
title - строка заголовка диалогового окна
optionType - целое число, определяющее доступные варианты в диалоговом окне: YES_NO_OPTION, YES_NO_CANCEL_OPTION или OK_CANCEL_OPTION
messageType - целое число, обозначающее тип сообщения; в основном используется для определения значка из подключаемого Look and Feel: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE или PLAIN_MESSAGE
Возвращает:
целое число, указывающее на выбранный пользователем вариант
Исключения:
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 в основном используется для предоставления значка по умолчанию из look and feel.
Параметры:
parentComponent - определяет Frame, в котором отображается диалоговое окно; если null или если у parentComponent нет Frame, используется Frame по умолчанию
message - объект для отображения
title - строка заголовка диалогового окна
optionType - целое число (int), определяющее доступные варианты в диалоговом окне: YES_NO_OPTION, YES_NO_CANCEL_OPTION или OK_CANCEL_OPTION
messageType - целое число (int), обозначающее тип сообщения, в основном используется для определения значка из подключаемого Look and Feel: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE или PLAIN_MESSAGE
icon - значок для отображения в диалоговом окне
Возвращает:
целое число (int), указывающее на выбранный пользователем вариант
Исключения:
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, то варианты предоставляются оформлением (look and feel).

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

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

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

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

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

showInternalConfirmDialog

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

showInternalOptionDialog

public static int showInternalOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue)
Отображает внутреннюю панель диалогового окна с указанным значком, в которой начальный выбор определяется параметром initialValue, а количество вариантов выбора определяется параметром optionType.

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

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

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

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 остается за UI, но обычно используется 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)
Возвращает панель рабочего стола (desktop pane) указанного компонента.
Параметры:
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
См. также:
  • setRootFrame(Frame)
  • GraphicsEnvironment.isHeadless()

setUI

@BeanProperty(hidden=true, description="The UI object that implements the optionpane's LookAndFeel") public void setUI(OptionPaneUI ui)
Устанавливает объект UI, который реализует L&F для этого компонента.
Параметры:
ui - объект L&F OptionPaneUI
См. также:
  • UIDefaults.getUI(JComponent)

getUI

public OptionPaneUI getUI()
Возвращает объект UI, который реализует L&F для этого компонента.
Переопределяет:
getUI в классе JComponent
Возвращает:
объект OptionPaneUI

updateUI

public void updateUI()
Уведомление от UIManager об изменении L&F. Заменяет текущий объект UI на последнюю версию из UIManager.
Переопределяет:
updateUI в классе JComponent
См. также:
  • JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает имя класса UI, который реализует L&F для этого компонента.
Переопределяет:
getUIClassID в классе JComponent
Возвращает:
строку "OptionPaneUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(JComponent)

setMessage

@BeanProperty(preferred=true, description="The optionpane's message object.") public void setMessage(Object newMessage)
Устанавливает объект сообщения панели параметров.
Параметры:
newMessage - Object для отображения
См. также:
  • getMessage()

getMessage

public Object getMessage()
Возвращает объект сообщения, отображаемый этой панелью.
Возвращает:
отображаемый Object
См. также:
  • setMessage(Object)

setIcon

@BeanProperty(preferred=true, description="The option pane's type icon.") public void setIcon(Icon newIcon)
Устанавливает значок для отображения. Если значение отлично от null, внешний вид и функциональность (look and feel) не предоставляют значок.
Параметры:
newIcon - Icon для отображения
См. также:
  • getIcon()

getIcon

public Icon getIcon()
Возвращает значок, отображаемый этой панелью.
Возвращает:
отображаемый Icon
См. также:
  • setIcon(Icon)

setValue

@BeanProperty(preferred=true, description="The option pane's value object.") public void setValue(Object newValue)
Устанавливает значение, выбранное пользователем.
Параметры:
newValue - выбранное значение
См. также:
  • getValue()

getValue

public Object getValue()
Возвращает значение, выбранное пользователем. Значение UNINITIALIZED_VALUE означает, что пользователь еще не сделал выбор, null означает, что пользователь закрыл окно, ничего не выбрав. В противном случае возвращаемое значение будет одним из вариантов, определенных в этом объекте.
Возвращает:
значение Object, выбранное пользователем, UNINITIALIZED_VALUE, если пользователь еще не сделал выбор, или null, если пользователь закрыл окно без выбора
См. также:
  • setValue(Object)

setOptions

@BeanProperty(description="The option pane's options objects.") public void setOptions(Object[] newOptions)
Задает варианты выбора, отображаемые этой панелью. Если элемент в newOptions является Component, он добавляется непосредственно на панель, в противном случае для элемента создается кнопка.
Параметры:
newOptions - массив Objects, которые создают кнопки, на которые может нажать пользователь, или произвольные Components для добавления на панель
См. также:
  • getOptions()

getOptions

public Object[] getOptions()
Возвращает варианты выбора, доступные пользователю.
Возвращает:
массив Objects, предоставляющих пользователю варианты выбора
См. также:
  • setOptions(Object[])

setInitialValue

@BeanProperty(preferred=true, description="The option pane's initial value object.") public void setInitialValue(Object newInitialValue)
Задает начальное значение, которое должно быть активировано, — Component, который имеет фокус при первоначальном отображении панели.
Параметры:
newInitialValue - объект Object, который получает начальный фокус ввода с клавиатуры
См. также:
  • getInitialValue()

getInitialValue

public Object getInitialValue()
Возвращает начальное значение.
Возвращает:
объект Object, который получает начальный фокус ввода с клавиатуры
См. также:
  • setInitialValue(Object)

setMessageType

@BeanProperty(preferred=true, description="The option pane's message type.") public void setMessageType(int newType)
Задает тип сообщения панели параметров. Тип сообщения используется Look and Feel для определения значка для отображения (если он не указан), а также, возможно, способа компоновки parentComponent.
Параметры:
newType - целое число, определяющее тип отображаемого сообщения: ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE или PLAIN_MESSAGE
Исключения:
RuntimeException - если newType не является одним из допустимых значений, перечисленных выше
См. также:
  • getMessageType()

getMessageType

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

setOptionType

@BeanProperty(preferred=true, description="The option pane's option type.") public void setOptionType(int newType)
Задает параметры для отображения. Тип параметров используется Look and Feel для определения того, какие кнопки следует показывать (если параметры не предоставлены).
Параметры:
newType - целое число, задающее параметры, которые должен отображать L&F: DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION или OK_CANCEL_OPTION
Исключения:
RuntimeException - если newType не является одним из допустимых значений, перечисленных выше
См. также:
  • getOptionType()
  • setOptions(Object[])

getOptionType

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

setSelectionValues

@BeanProperty(description="The option pane's selection values.") public void setSelectionValues(Object[] newValues)
Задает входные значения для выбора в панели, предоставляющей пользователю список элементов на выбор. (Пользовательский интерфейс предоставляет элемент управления для выбора одного из значений.) Значение null означает, что пользователь может ввести все, что пожелает, обычно с помощью JTextField.

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

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

getSelectionValues

public Object[] getSelectionValues()
Возвращает входные значения для выбора.
Возвращает:
массив Objects, доступных пользователю для выбора
См. также:
  • setSelectionValues(Object[])

setInitialSelectionValue

@BeanProperty(description="The option pane's initial selection value object.") public void setInitialSelectionValue(Object newValue)
Задает входное значение, которое первоначально отображается пользователю как выбранное. Используется только в том случае, если wantsInput имеет значение true.
Параметры:
newValue - первоначально выбранное значение
См. также:
  • setSelectionValues(Object[])
  • getInitialSelectionValue()

getInitialSelectionValue

public Object getInitialSelectionValue()
Возвращает входное значение, которое отображается пользователю как первоначально выбранное.
Возвращает:
первоначально выбранное значение
См. также:
  • setInitialSelectionValue(Object)
  • setSelectionValues(Object[])

setInputValue

@BeanProperty(preferred=true, description="The option pane's input value object.") public void setInputValue(Object newValue)
Устанавливает входное значение, которое было выбрано или введено пользователем. Используется только в том случае, если wantsInput имеет значение true. Обратите внимание, что этот метод вызывается внутри панели параметров (в ответ на действие пользователя) и, как правило, не должен вызываться клиентскими программами. Чтобы задать входное значение, первоначально отображаемое пользователю как выбранное, используйте setInitialSelectionValue.
Параметры:
newValue - Object, используемый для установки значения, указанного пользователем (обычно в текстовом поле)
См. также:
  • setSelectionValues(Object[])
  • setInitialSelectionValue(Object)
  • setWantsInput(boolean)
  • getInputValue()

getInputValue

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

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

Это связанное свойство (bound property).

Параметры:
newValue - если true, предоставляется компонент ввода, родителем которого является parentComponent, чтобы позволить пользователю ввести значение.
См. также:
  • setSelectionValues(Object[])
  • setInputValue(Object)

getWantsInput

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

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

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация по Java SE, где содержатся более подробные описания, ориентированные на разработчиков, с концептуальными обзорами, определениями терминов, обходными путями и рабочими примерами кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком компании Oracle и/или ее дочерних компаний в США и других странах.
Авторские права © 1993, 2026, Oracle и/или ее дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API