Spec-Zone.ru › OpenJDK 27

Класс BasicOptionPaneUI

java.lang.Object
javax.swing.plaf.ComponentUI
javax.swing.plaf.OptionPaneUI
javax.swing.plaf.basic.BasicOptionPaneUI
Прямые известные подклассы:
SynthOptionPaneUI
public class BasicOptionPaneUI extends OptionPaneUI
Предоставляет базовое оформление для JOptionPane. BasicMessagePaneUI позволяет помещать значок, сообщение и кнопки в Container. Обычно компоновка выглядит следующим образом: 
       ------------------
       | i | message    |
       | c | message    |
       | o | message    |
       | n | message    |
       ------------------
       |     buttons    |
       |________________|
значок является экземпляром Icon, заключённым в JLabel. Сообщение представляет собой непрозрачный объект, который проверяется следующим образом: если сообщение является Component, оно добавляется в Container; если это Icon, оно заключается в JLabel и добавляется в Container; в противном случае оно заключается в JLabel.

Указанная выше компоновка используется, если свойство ComponentOrientation панели параметров имеет горизонтальную ориентацию слева направо. Для других ориентаций компоновка соответствующим образом изменяется.

Container, сообщение, значок и кнопки определяются абстрактными методами.

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

Модификатор и тип Класс Описание
class  BasicOptionPaneUI.ButtonActionListener
Этот класс следует рассматривать как «защищённый» внутренний класс.
static class  BasicOptionPaneUI.ButtonAreaLayout
ButtonAreaLayout ведёт себя подобно FlowLayout.
class  BasicOptionPaneUI.PropertyChangeHandler
Этот класс следует рассматривать как «защищённый» внутренний класс.

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

Модификатор и тип Поле Описание
protected boolean hasCustomComponents
При проверке компонента это значение устанавливается в true, если компонент содержится в сообщении или кнопках.
protected Component initialFocusComponent
Компонент, который получит фокус при вызове selectInitialValue.
protected JComponent inputComponent
JComponent, предоставляющий поле ввода, если optionPane.getWantsInput() возвращает true.
static final int MinimumHeight
Минимальная высота JOptionPane.
protected Dimension minimumSize
Размер JOptionPane.
static final int MinimumWidth
Минимальная ширина JOptionPane.
protected JOptionPane optionPane
JOptionPane, для которого получатель предоставляет оформление.
protected PropertyChangeListener propertyChangeListener
Экземпляр PropertyChangeListener.

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

Конструктор Описание
BasicOptionPaneUI()
Создаёт BasicOptionPaneUI.

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

Модификатор и тип Метод Описание
protected void addButtonComponents(Container container, Object[] buttons, int initialIndex)
Создаёт подходящий объект для представления каждого объекта в buttons и добавляет его в container.
protected void addIcon(Container top)
Создаёт JLabel, представляющий значок, возвращаемый getIcon, и добавляет его в top.
protected void addMessageComponents(Container container, GridBagConstraints cons, Object msg, int maxll, boolean internallyCreated)
Создаёт подходящий объект для представления msg и помещает его в container.
protected void burstStringInto(Container c, String d, int maxll)
Рекурсивно создаёт экземпляры JLabel для представления d.
boolean containsCustomComponents(JOptionPane op)
Возвращает true, если при последнем вызове validateComponent сообщение или кнопки содержали подкласс Component.
protected ActionListener createButtonActionListener(int buttonIndex)
Создаёт новый экземпляр ButtonActionListener.
protected Container createButtonArea()
Создаёт и возвращает Container, содержащий кнопки.
protected LayoutManager createLayoutManager()
Возвращает менеджер компоновки.
protected Container createMessageArea()
Вызывается из installComponents для создания Container, содержащего текст сообщения.
protected PropertyChangeListener createPropertyChangeListener()
Возвращает экземпляр PropertyChangeListener.
protected Container createSeparator()
Возвращает разделитель.
static ComponentUI createUI(JComponent x)
Создаёт новый экземпляр BasicOptionPaneUI.
protected Object[] getButtons()
Возвращает кнопки для отображения из JOptionPane, для которого получатель предоставляет оформление.
protected Icon getIcon()
Возвращает значок из JOptionPane, для которого получатель предоставляет оформление, или значок по умолчанию, возвращаемый getDefaultIcon.
protected Icon getIconForType(int messageType)
Возвращает значок для указанного типа.
protected int getInitialValueIndex()
Возвращает начальный индекс кнопки, которую нужно выбрать.
protected int getMaxCharactersPerLineCount()
Возвращает максимальное количество символов в строке.
protected Object getMessage()
Возвращает сообщение для отображения из JOptionPane, для которого получатель предоставляет оформление.
Dimension getMinimumOptionPaneSize()
Возвращает минимальный размер панели параметров.
Dimension getPreferredSize(JComponent c)
Если c является JOptionPane, в который входит получатель, возвращаемый предпочтительный размер равен максимальному из предпочтительного размера LayoutManager для JOptionPane и getMinimumOptionPaneSize.
protected boolean getSizeButtonsToSameWidth()
Возвращает true; базовое оформление требует, чтобы все кнопки имели одинаковую ширину.
protected void installComponents()
Регистрирует компоненты.
protected void installDefaults()
Устанавливает свойства по умолчанию.
protected void installKeyboardActions()
Регистрирует действия клавиатуры.
protected void installListeners()
Регистрирует слушателей.
void installUI(JComponent c)
Устанавливает получателя в качестве оформления для переданного JOptionPane.
protected void resetInputValue()
Устанавливает значение ввода в панели параметров, для которой получатель предоставляет оформление, на основе значения в inputComponent.
void selectInitialValue(JOptionPane op)
Если inputComponent не равен null, фокус запрашивается для него; в противном случае фокус запрашивается для значения по умолчанию.
protected void uninstallComponents()
Отменяет регистрацию компонентов.
protected void uninstallDefaults()
Удаляет свойства по умолчанию.
protected void uninstallKeyboardActions()
Отменяет регистрацию действий клавиатуры.
protected void uninstallListeners()
Отменяет регистрацию слушателей.
void uninstallUI(JComponent c)
Удаляет получателя из контроллера оформления переданной панели с разделителем.

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

contains, getAccessibleChild, getAccessibleChildrenCount, getBaseline, getBaselineResizeBehavior, getMaximumSize, getMinimumSize, paint, update
Модификатор и тип Метод Описание
boolean contains(JComponent c, int x, int y)
Возвращает true, если указанная точка x,y находится внутри формы указанного компонента, определённой оформлением.
Accessible getAccessibleChild(JComponent c, int i)
Возвращает i-го дочернего элемента Accessible объекта.
int getAccessibleChildrenCount(JComponent c)
Возвращает количество доступных дочерних элементов объекта.
int getBaseline(JComponent c, int width, int height)
Возвращает базовую линию.
Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)
Возвращает значение перечисления, указывающее, как изменяется базовая линия компонента при изменении его размера.
Dimension getMaximumSize(JComponent c)
Возвращает максимальный размер указанного компонента, соответствующий оформлению.
Dimension getMinimumSize(JComponent c)
Возвращает минимальный размер указанного компонента, соответствующий оформлению.
void paint(Graphics g, JComponent c)
Отображает указанный компонент в соответствии с оформлением.
void update(Graphics g, JComponent c)
Уведомляет этот делегат пользовательского интерфейса о необходимости отобразить указанный компонент.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 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()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания.
final void wait(long timeoutMillis)
Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного времени.
final void wait(long timeoutMillis, int nanos)
Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного времени.

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

MinimumWidth

public static final int MinimumWidth
Минимальная ширина JOptionPane.
См. также:
  • Значения констант полей

MinimumHeight

public static final int MinimumHeight
Минимальная высота JOptionPane.
См. также:
  • Значения констант полей

optionPane

protected JOptionPane optionPane
JOptionPane, для которого получатель предоставляет оформление.

minimumSize

protected Dimension minimumSize
Размер JOptionPane.

inputComponent

protected JComponent inputComponent
JComponent, используемый для ввода, если optionPane.getWantsInput() возвращает true.

initialFocusComponent

protected Component initialFocusComponent
Компонент, который получит фокус при вызове selectInitialValue.

hasCustomComponents

protected boolean hasCustomComponents
В методе validateComponent это значение устанавливается в true, если сообщение или кнопки содержат Component.

propertyChangeListener

protected PropertyChangeListener propertyChangeListener
Экземпляр PropertyChangeListener.

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

BasicOptionPaneUI

public BasicOptionPaneUI()
Создает BasicOptionPaneUI.

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

createUI

public static ComponentUI createUI(JComponent x)
Создает новый экземпляр BasicOptionPaneUI.
Параметры:
x — компонент
Возвращает:
новый экземпляр BasicOptionPaneUI

installUI

public void installUI(JComponent c)
Устанавливает получателя в качестве оформления (L&F) переданного JOptionPane.
Переопределяет:
installUI в классе ComponentUI
Параметры:
c — компонент, для которого устанавливается этот делегат пользовательского интерфейса
См. также:
  • ComponentUI.uninstallUI(JComponent)
  • JComponent.setUI(ComponentUI)
  • JComponent.updateUI()

uninstallUI

public void uninstallUI(JComponent c)
Удаляет получателя из контроллера оформления (L&F) переданной панели с разделителем.
Переопределяет:
uninstallUI в классе ComponentUI
Параметры:
c — компонент, у которого удаляется этот делегат пользовательского интерфейса; этот аргумент часто игнорируется, но может использоваться, если объект пользовательского интерфейса не содержит состояния и совместно используется несколькими компонентами
См. также:
  • ComponentUI.installUI(JComponent)
  • JComponent.updateUI()

installDefaults

protected void installDefaults()
Устанавливает свойства по умолчанию.

uninstallDefaults

protected void uninstallDefaults()
Удаляет свойства по умолчанию.

installComponents

protected void installComponents()
Регистрирует компоненты.

uninstallComponents

protected void uninstallComponents()
Отменяет регистрацию компонентов.

createLayoutManager

protected LayoutManager createLayoutManager()
Возвращает менеджер компоновки.
Возвращает:
менеджер компоновки

installListeners

protected void installListeners()
Регистрирует слушателей.

uninstallListeners

protected void uninstallListeners()
Отменяет регистрацию слушателей.

createPropertyChangeListener

protected PropertyChangeListener createPropertyChangeListener()
Возвращает экземпляр PropertyChangeListener.
Возвращает:
экземпляр PropertyChangeListener

installKeyboardActions

protected void installKeyboardActions()
Регистрирует действия клавиатуры.

uninstallKeyboardActions

protected void uninstallKeyboardActions()
Отменяет регистрацию действий клавиатуры.

getMinimumOptionPaneSize

public Dimension getMinimumOptionPaneSize()
Возвращает минимальный размер панели параметров. Этот метод в первую очередь предназначен для подклассов, которым требуется задать другой минимальный размер.
Возвращает:
минимальный размер панели параметров

getPreferredSize

public Dimension getPreferredSize(JComponent c)
Если c является JOptionPane, в котором содержится получатель, возвращаемый предпочтительный размер представляет собой максимум из предпочтительного размера LayoutManager для JOptionPane и getMinimumOptionPaneSize.
Переопределяет:
getPreferredSize в классе ComponentUI
Параметры:
c — компонент, предпочтительный размер которого запрашивается; этот аргумент часто игнорируется, но может использоваться, если объект пользовательского интерфейса не содержит состояния и совместно используется несколькими компонентами
Возвращает:
объект Dimension, содержащий предпочтительный размер заданного компонента, соответствующий оформлению
См. также:
  • JComponent.getPreferredSize()
  • LayoutManager.preferredLayoutSize(Container)

createMessageArea

protected Container createMessageArea()
Вызывается из installComponents для создания Container, содержащего текст сообщения. Значок создается вызовом addIcon.
Возвращает:
экземпляр Container

addMessageComponents

protected void addMessageComponents(Container container, GridBagConstraints cons, Object msg, int maxll, boolean internallyCreated)
Создает подходящий объект для представления msg и помещает его в container. Если msg является экземпляром Component, он добавляется напрямую; если это Icon, для его представления создается JLabel; в противном случае для строки создается JLabel. Если msg является Object[], этот метод рекурсивно вызывается для дочерних элементов. internallyCreated имеет значение true, если msg является экземпляром Component и был создан этим методом (это используется для правильной установки hasCustomComponents только в том случае, если internallyCreated имеет значение false).
Параметры:
container — контейнер
cons — экземпляр GridBagConstraints
msg — сообщение
maxll — максимальная длина
internallyCreated — true, если компонент создан этим методом

getMessage

protected Object getMessage()
Возвращает сообщение для отображения из JOptionPane, для которого получатель предоставляет оформление.
Возвращает:
сообщение для отображения

addIcon

protected void addIcon(Container top)
Создает и добавляет JLabel, представляющий значок, возвращаемый getIcon, в top. Этот метод вызывается из createMessageArea.
Параметры:
top — контейнер

getIcon

protected Icon getIcon()
Возвращает значок из JOptionPane, для которого получатель предоставляет оформление, или значок по умолчанию, возвращаемый getDefaultIcon.
Возвращает:
значок

getIconForType

protected Icon getIconForType(int messageType)
Возвращает значок для заданного типа.
Параметры:
messageType — тип сообщения
Возвращает:
значок для заданного типа

getMaxCharactersPerLineCount

protected int getMaxCharactersPerLineCount()
Возвращает максимальное количество символов в строке.
Возвращает:
максимальное количество символов в строке

burstStringInto

protected void burstStringInto(Container c, String d, int maxll)
Рекурсивно создает экземпляры JLabel для представления d. Каждый экземпляр JLabel добавляется в c.
Параметры:
c — контейнер
d — текст
maxll — максимальная длина текста

createSeparator

protected Container createSeparator()
Возвращает разделитель.
Возвращает:
разделитель

createButtonArea

protected Container createButtonArea()
Создает и возвращает Container, содержащий кнопки. Кнопки создаются вызовом getButtons.
Возвращает:
Container, содержащий кнопки

addButtonComponents

protected void addButtonComponents(Container container, Object[] buttons, int initialIndex)
Создает подходящий объект для представления каждого объекта в buttons и добавляет его в container. Этот метод отличается от addMessageComponents тем, что рекурсивно обрабатывает buttons и, если кнопка не является Component, создает экземпляр JButton.
Параметры:
container — контейнер
buttons — массив кнопок
initialIndex — начальный индекс

createButtonActionListener

protected ActionListener createButtonActionListener(int buttonIndex)
Создает новый экземпляр ButtonActionListener.
Параметры:
buttonIndex — индекс кнопки
Возвращает:
новый экземпляр ButtonActionListener

getButtons

protected Object[] getButtons()
Возвращает кнопки для отображения из JOptionPane, для которого получатель предоставляет оформление. Если в JOptionPane заданы параметры, они будут возвращены; в противном случае, если optionType имеет значение YES_NO_OPTION, возвращается yesNoOptions; если тип имеет значение YES_NO_CANCEL_OPTION, возвращается yesNoCancelOptions; иначе возвращается defaultButtons.
Возвращает:
кнопки для отображения из JOptionPane

getSizeButtonsToSameWidth

protected boolean getSizeButtonsToSameWidth()
Возвращает true; базовое оформление (L&F) требует, чтобы все кнопки имели одинаковую ширину.
Возвращает:
true, если все кнопки должны иметь одинаковую ширину

getInitialValueIndex

protected int getInitialValueIndex()
Возвращает начальный индекс кнопки для выбора. Индекс вычисляется на основе начального значения JOptionPane и его параметров либо равен 0.
Возвращает:
начальный индекс кнопки для выбора

resetInputValue

protected void resetInputValue()
Задает значение ввода панели параметров, для которой получатель предоставляет оформление, на основе значения inputComponent.

selectInitialValue

public void selectInitialValue(JOptionPane op)
Если inputComponent не равен null, фокус запрашивается для него; в противном случае фокус запрашивается для значения по умолчанию.
Указан в:
selectInitialValue в классе OptionPaneUI
Параметры:
op — JOptionPane

containsCustomComponents

public boolean containsCustomComponents(JOptionPane op)
Возвращает true, если при последнем вызове validateComponent сообщение или кнопки содержали подкласс Component.
Указан в:
containsCustomComponents в классе OptionPaneUI
Параметры:
op — JOptionPane
Возвращает:
true, если заданный JOptionPane содержит созданные пользователем Components

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по 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