Класс 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 в validateComponent, если компонент содержится в сообщении или кнопках.
`protected Component`	`initialFocusComponent` Компонент, который получит фокус при вызове selectInitialValue.
`protected JComponent`	`inputComponent` JComponent для ввода, если optionPane.getWantsInput() возвращает true.
`static int`	`MinimumHeight`
`protected Dimension`	`minimumSize`
`static int`	`MinimumWidth`
`protected JOptionPane`	`optionPane` `JOptionPane` для которого получатель предоставляет вид и ощущения.
`protected PropertyChangeListener`	`propertyChangeListener`

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

Конструктор и описание
`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)`
`protected Container`	`createButtonArea()` Создаёт и возвращает контейнер, содержащий кнопки.
`protected LayoutManager`	`createLayoutManager()`
`protected Container`	`createMessageArea()` Получает сообщение от installComponents для создания контейнера, содержащего тело сообщения.
`protected PropertyChangeListener`	`createPropertyChangeListener()`
`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)` Устанавливает получателя в качестве L&F для переданного `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)` Удаляет получателя из контроллера L&F переданной панели.

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

contains, getAccessibleChild, getAccessibleChildrenCount, getBaseline, getBaselineResizeBehavior, getMaximumSize, getMinimumSize, paint, update

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

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

Поля

MinimumWidth

public static final int MinimumWidth

См. также:: Значения константных полей

MinimumHeight

public static final int MinimumHeight

См. также:: Значения константных полей

optionPane

protected JOptionPane optionPane

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

minimumSize

protected Dimension minimumSize

inputComponent

protected JComponent inputComponent

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

initialFocusComponent

protected Component initialFocusComponent

Компонент, получающий фокус при вызове selectInitialValue.

hasCustomComponents

protected boolean hasCustomComponents

Устанавливается в значение true в validateComponent, если компонент содержится в сообщении или кнопках.

propertyChangeListener

protected PropertyChangeListener propertyChangeListener

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

BasicOptionPaneUI

public BasicOptionPaneUI()

Методы

createUI

public static ComponentUI createUI(JComponent x)

Создаёт новый экземпляр BasicOptionPaneUI.

installUI

public void installUI(JComponent c)

Устанавливает получателя в качестве L&F для переданного JOptionPane.

Переопределяет:: installUI в классе ComponentUI
Параметры:: c - компонент, в котором устанавливается этот делегат UI
См. также:: ComponentUI.uninstallUI(javax.swing.JComponent), JComponent.setUI(javax.swing.plaf.ComponentUI), JComponent.updateUI()

uninstallUI

public void uninstallUI(JComponent c)

Удаляет получателя из контроллера L&F переданного разделительного экрана.

Переопределяет:: uninstallUI в классе ComponentUI
Параметры:: c - компонент, из которого удаляется этот делегат UI; этот аргумент часто игнорируется, но может использоваться, если объект UI является бессостоятельным и используется несколькими компонентами
См. также:: ComponentUI.installUI(javax.swing.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()

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 - компонент, предпочтительный размер которого запрашивается; этот аргумент часто игнорируется, но может использоваться, если объект UI является бессостоятельным и используется несколькими компонентами
См. также:: JComponent.getPreferredSize(), LayoutManager.preferredLayoutSize(java.awt.Container)

createMessageArea

protected Container createMessageArea()

Вызывается installComponents для создания контейнера, содержащего тело сообщения. Иконка создаётся с помощью вызова addIcon.

addMessageComponents

protected void addMessageComponents(Container container,
                                    GridBagConstraints cons,
                                    Object msg,
                                    int maxll,
                                    boolean internallyCreated)

Создаёт соответствующий объект, представляющий msg и помещает его в container. Если msg является экземпляром Component, он добавляется напрямую, если это Icon, создаётся JLabel для его представления, в противном случае создаётся JLabel для строки. Если d является Object[], этот метод вызывается рекурсивно для дочерних элементов. internallyCreated равно true, если Objc является экземпляром Component и был создан этим методом (используется для правильного установки hasCustomComponents только если !internallyCreated).

getMessage

protected Object getMessage()

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

addIcon

protected void addIcon(Container top)

Создаёт и добавляет JLabel, представляющий иконку, возвращаемую из getIcon, в top. Вызывается из createMessageArea

getIcon

protected Icon getIcon()

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

getIconForType

protected Icon getIconForType(int messageType)

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

getMaxCharactersPerLineCount

protected int getMaxCharactersPerLineCount()

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

burstStringInto

protected void burstStringInto(Container c,
                               String d,
                               int maxll)

Рекурсивно создаёт новые экземпляры JLabel для представления d. Каждый экземпляр JLabel добавляется в c.

createSeparator

protected Container createSeparator()

createButtonArea

protected Container createButtonArea()

Создаёт и возвращает контейнер, содержащий кнопки. Кнопки создаются с помощью вызова getButtons.

addButtonComponents

protected void addButtonComponents(Container container,
                                   Object[] buttons,
                                   int initialIndex)

Создаёт соответствующий объект для представления каждого из объектов в buttons и добавляет его в container. Отличается от addMessageComponents тем, что выполняет рекурсию по buttons, и если кнопка не является Component, создаёт экземпляр JButton.

createButtonActionListener

protected ActionListener createButtonActionListener(int buttonIndex)

getButtons

protected Object[] getButtons()

Возвращает кнопки для отображения из JOptionPane, для которого получатель предоставляет вид и ощущения. Если в JOptionPane установлены опции, они будут предоставлены, иначе, если тип опций YES_NO_OPTION, возвращается yesNoOptions, если тип — YES_NO_CANCEL_OPTION — yesNoCancelOptions, в противном случае возвращаются defaultButtons.

getSizeButtonsToSameWidth

protected boolean getSizeButtonsToSameWidth()

Возвращает true, если базовая L&F хочет, чтобы все кнопки имели одинаковую ширину.

getInitialValueIndex

protected int getInitialValueIndex()

Возвращает начальный индекс в кнопках для выбора. Индекс вычисляется из начального значения из JOptionPane и опций JOptionPane или 0.

resetInputValue

protected void resetInputValue()

Устанавливает значение ввода в диалоговом окне с опциями, для которого получатель предоставляет вид и ощущения, на основе значения в inputComponent.

selectInitialValue

public void selectInitialValue(JOptionPane op)

Если inputComponent не null, фокус запрашивается на нём, иначе запрашивается на значении по умолчанию.

Определено в:: selectInitialValue в классе OptionPaneUI

containsCustomComponents

public boolean containsCustomComponents(JOptionPane op)

Возвращает true, если в последнем вызове validateComponent сообщение или кнопки содержали подкласс Component.

Определено в:: containsCustomComponents в классе OptionPaneUI

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.