Класс BasicComboBoxUI

public class BasicComboBoxUI
extends ComboBoxUI

Базовая реализация пользовательского интерфейса для JComboBox.

Комбо-бокс — это составной компонент, который представляет собой агрегацию нескольких более простых компонентов. Этот класс создаёт и управляет слушателями в комбо-боксе и модели комбо-бокса. Эти слушатели обновляют пользовательский интерфейс в ответ на изменения свойств и состояния комбо-бокса.

Все обработка событий обрабатывается классами-слушателями, созданными с помощью методов createxxxListener() и внутренними классами. Вы можете изменить поведение этого класса, переопределив методы createxxxListener() и предоставив собственных слушателей событий или унаследовавшись от тех, которые представлены в этом классе.

Для добавления специфических действий, переопределите installKeyboardActions для добавления действий в ответ на привязки клавиш. См. статью Как использовать привязки клавиш

Поля

comboBox

protected JComboBox comboBox

hasFocus

protected boolean hasFocus

Это защищенное поле зависит от реализации. Не пытайтесь получить к нему доступ напрямую или переопределять его.

listBox

protected JList listBox

currentValuePane

protected CellRendererPane currentValuePane

popup

protected ComboPopup popup

editor

protected Component editor

кнопкаСтрелки

protected JButton arrowButton

keyListener

protected KeyListener keyListener

Это защищенное поле зависит от реализации. Не пытайтесь получить к нему доступ напрямую или переопределять его. Вместо этого переопределите метод создания слушателя.

См. также:

createKeyListener()

focusListener

protected FocusListener focusListener

Это защищенное поле зависит от реализации. Не пытайтесь получить к нему доступ напрямую или переопределять его. Вместо этого переопределите метод создания слушателя.

См. также:

createFocusListener()

propertyChangeListener

protected PropertyChangeListener propertyChangeListener

Это защищенное поле зависит от реализации. Не пытайтесь получить к нему доступ напрямую или переопределять его. Вместо этого переопределите метод создания слушателя.

См. также:

createPropertyChangeListener()

itemListener

protected ItemListener itemListener

Это защищенное поле зависит от реализации. Не пытайтесь получить к нему доступ напрямую или переопределять его. Вместо этого переопределите метод создания слушателя.

См. также:

createItemListener()

popupMouseListener

protected MouseListener popupMouseListener

popupMouseMotionListener

protected MouseMotionListener popupMouseMotionListener

popupKeyListener

protected KeyListener popupKeyListener

listDataListener

protected ListDataListener listDataListener

Это защищенное поле зависит от реализации. Не пытайтесь получить к нему доступ напрямую или переопределять его. Вместо этого переопределите метод создания слушателя.

См. также:

createListDataListener()

isMinimumSizeDirty

protected boolean isMinimumSizeDirty

кешированныйМинимальныйРазмер

protected Dimension cachedMinimumSize

кнопкаКвадратнойФормы

protected boolean squareButton

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

С:

1.7

отступ

protected Insets padding

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

С:

1.7

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

BasicComboBoxUI

public BasicComboBoxUI()

Методы

createUI

public static ComponentUI createUI(JComponent c)

installUI

public void installUI(JComponent c)

Описание скопировано из класса: ComponentUI

Настраивает указанный компонент в соответствии со стилем внешнего вида. Этот метод вызывается, когда экземпляр ComponentUI устанавливается в качестве делегата UI для указанного компонента. Этот метод должен полностью настроить компонент для стиля внешнего вида, включая следующее:

1. Установить значения свойств по умолчанию для цвета, шрифтов, границ, значков, непрозрачности и т. д. на компоненте. По возможности значения свойств, инициализированные программой-клиентом, не должны переопределяться.
2. Установить LayoutManager на компоненте при необходимости.
3. Создать/добавить любые необходимые подкомпоненты к компоненту.
4. Создать/установить обработчики событий на компоненте.
5. Создать/установить PropertyChangeListener на компоненте, чтобы должным образом обнаруживать и реагировать на изменения свойств компонента.
6. Установить пользовательский интерфейс клавиатуры (мнемоники, перемещение по элементам и т. д.) на компоненте.
7. Инициализировать любые необходимые данные экземпляра.

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

installUI в классе ComponentUI

Параметры:

c - компонент, на котором устанавливается этот делегат UI

См. также:

ComponentUI.uninstallUI(javax.swing.JComponent), JComponent.setUI(javax.swing.plaf.ComponentUI), JComponent.updateUI()

uninstallUI

public void uninstallUI(JComponent c)

Описание скопировано из класса: ComponentUI

Отменяет настройку, выполненную на указанном компоненте во время installUI. Этот метод вызывается, когда этот экземпляр UIComponent удаляется как делегат UI для указанного компонента. Этот метод должен отменить настройки, выполненные в installUI, и тщательно оставить экземпляр JComponent в чистом состоянии (без лишних слушателей, объектов свойств, специфичных для внешнего вида и т. д.). Это должно включать в себя следующее:

1. Удалить любые установленные UI границы от компонента.
2. Удалить любые установленные UI менеджеры компоновки от компонента.
3. Удалить любые добавленные UI подкомпоненты от компонента.
4. Удалить любые добавленные UI обработчики событий/свойств от компонента.
5. Удалить любой установленный UI пользовательский интерфейс клавиатуры от компонента.
6. Установить в null любые выделенные объекты данных экземпляра, чтобы разрешить сборку мусора.

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

uninstallUI в классе ComponentUI

Параметры:

c - компонент, из которого удаляется этот делегат UI; этот аргумент часто игнорируется, но может быть использован, если объект UI является бессостоятельным и используется несколькими компонентами

См. также:

ComponentUI.installUI(javax.swing.JComponent), JComponent.updateUI()

installDefaults

protected void installDefaults()

Устанавливает цвета по умолчанию, шрифт по умолчанию, рендерер по умолчанию и редактор по умолчанию в JComboBox.

installListeners

protected void installListeners()

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

uninstallDefaults

protected void uninstallDefaults()

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

uninstallListeners

protected void uninstallListeners()

Удаляет установленные слушатели из раскрывающегося списка и его модели. Количество и типы слушателей, удаленных в этом методе, должны совпадать с теми, что были добавлены в installListeners

createPopup

protected ComboPopup createPopup()

Создает часть раскрывающегося списка раскрывающегося списка.

Возвращает:

экземпляр ComboPopup

См. также:

ComboPopup

createKeyListener

protected KeyListener createKeyListener()

Создает KeyListener, который будет добавлен к раскрывающемуся списку. Если этот метод возвращает null, он не будет добавлен к раскрывающемуся списку.

Возвращает:

экземпляр KeyListener или null

createFocusListener

protected FocusListener createFocusListener()

Создает FocusListener, который будет добавлен к раскрывающемуся списку. Если этот метод возвращает null, он не будет добавлен к раскрывающемуся списку.

Возвращает:

экземпляр FocusListener или null

createListDataListener

protected ListDataListener createListDataListener()

Создает слушателя данных списка, который будет добавлен к ComboBoxModel. Если этот метод возвращает null, он не будет добавлен к модели раскрывающегося списка.

Возвращает:

экземпляр ListDataListener или null

createItemListener

protected ItemListener createItemListener()

Возвращает:

экземпляр ItemListener или null

createPropertyChangeListener

protected PropertyChangeListener createPropertyChangeListener()

Создает PropertyChangeListener, который будет добавлен к раскрывающемуся списку. Если этот метод возвращает null, он не будет добавлен к раскрывающемуся списку.

Возвращает:

экземпляр PropertyChangeListener или null

createLayoutManager

protected LayoutManager createLayoutManager()

Создает менеджер компоновки для управления компонентами, составляющими раскрывающийся список.

Возвращает:

экземпляр менеджера компоновки

createRenderer

protected ListCellRenderer createRenderer()

Создает рендерер по умолчанию, который будет использоваться в нередактируемом раскрывающемся списке. Рендерер по умолчанию будет использоваться только в том случае, если рендерер не был явно задан с помощью setRenderer.

Возвращает:

ListCellRender используемый для раскрывающегося списка

См. также:

JComboBox.setRenderer(javax.swing.ListCellRenderer<? super E>)

createEditor

protected ComboBoxEditor createEditor()

Создает редактор по умолчанию, который будет использоваться в редактируемых раскрывающихся списках. Редактор по умолчанию будет использоваться только в том случае, если редактор не был явно задан с помощью setEditor.

Возвращает:

ComboBoxEditor используемый для раскрывающегося списка

См. также:

JComboBox.setEditor(javax.swing.ComboBoxEditor)

installComponents

protected void installComponents()

Создает и инициализирует компоненты, составляющие составной раскрывающийся список. Этот метод вызывается в рамках процесса установки UI.

uninstallComponents

protected void uninstallComponents()

Составные компоненты, из которых состоит раскрывающийся список, отменяются и деинициализируются. Этот метод вызывается в рамках процесса отмены установки UI.

addEditor

public void addEditor()

Этот общедоступный метод зависит от реализации и должен быть закрытым. Не вызывайте и не переопределяйте. Чтобы реализовать конкретный редактор, создайте настраиваемый ComboBoxEditor

См. также:

createEditor(), JComboBox.setEditor(javax.swing.ComboBoxEditor), ComboBoxEditor

removeEditor

public void removeEditor()

Этот общедоступный метод зависит от реализации и должен быть закрытым. Не вызывайте и не переопределяйте.

См. также:

addEditor()

configureEditor

protected void configureEditor()

Этот защищённый метод специфичен для реализации и должен быть приватным. Не вызывать и не переопределять.

См. также:

addEditor()

unconfigureEditor

protected void unconfigureEditor()

Этот защищённый метод специфичен для реализации и должен быть приватным. Не вызывать и не переопределять.

См. также:

addEditor()

configureArrowButton

public void configureArrowButton()

Этот публичный метод специфичен для реализации и должен быть приватным. Не вызывать и не переопределять.

См. также:

createArrowButton()

unconfigureArrowButton

public void unconfigureArrowButton()

Этот публичный метод специфичен для реализации и должен быть приватным. Не вызывать и не переопределять.

См. также:

createArrowButton()

createArrowButton

protected JButton createArrowButton()

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

Возвращает:

кнопку, представляющую элемент управления всплывающим окном

isPopupVisible

public boolean isPopupVisible(JComboBox c)

Указывает, отображается ли всплывающее окно или нет.

Определено в:

isPopupVisible в классе ComboBoxUI

setPopupVisible

public void setPopupVisible(JComboBox c,
                            boolean v)

Скрывает всплывающее окно.

Определено в:

setPopupVisible в классе ComboBoxUI

isFocusTraversable

public boolean isFocusTraversable(JComboBox c)

Определяет, доступна ли фокусировка для JComboBox. Если JComboBox редактируемый, возвращает false, иначе возвращает true.

Определено в:

isFocusTraversable в классе ComboBoxUI

paint

public void paint(Graphics g,
                  JComponent c)

Описание скопировано из класса: ComponentUI

Отрисовывает указанный компонент соответствующим образом для внешнего вида и ощущения. Этот метод вызывается из метода ComponentUI.update при отрисовке указанного компонента. Подклассы должны переопределять этот метод и использовать указанный объект Graphics для отрисовки содержимого компонента.

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

paint в классе ComponentUI

Параметры:

g - контекст Graphics для отрисовки

c - компонент, который отрисовывается; этот аргумент часто игнорируется, но может использоваться, если объект UI является бессостоятельным и используется несколькими компонентами

См. также:

ComponentUI.update(java.awt.Graphics, javax.swing.JComponent)

getPreferredSize

public Dimension getPreferredSize(JComponent c)

Описание скопировано из класса: ComponentUI

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

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

getPreferredSize в классе ComponentUI

Параметры:

c - компонент, предпочтительный размер которого запрашивается; этот аргумент часто игнорируется, но может использоваться, если объект UI является бессостоятельным и используется несколькими компонентами

См. также:

JComponent.getPreferredSize(), LayoutManager.preferredLayoutSize(java.awt.Container)

getMinimumSize

public Dimension getMinimumSize(JComponent c)

Минимальный размер — это размер области отображения плюс отступы плюс кнопка.

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

getMinimumSize в классе ComponentUI

Параметры:

c - компонент, минимальный размер которого запрашивается; этот аргумент часто игнорируется, но может использоваться, если объект UI является бессостоятельным и используется несколькими компонентами

Возвращает:

объект Dimension или null

См. также:

JComponent.getMinimumSize(), LayoutManager.minimumLayoutSize(java.awt.Container), ComponentUI.getPreferredSize(javax.swing.JComponent)

getMaximumSize

public Dimension getMaximumSize(JComponent c)

Описание скопировано из класса: ComponentUI

Возвращает максимальный размер указанного компонента, соответствующий внешнему виду и ощущению. Если null возвращается, максимальный размер будет вычислен менеджером компоновки компонента (это предпочтительный подход для любого компонента со специфическим менеджером компоновки). Реализация по умолчанию этого метода вызывает getPreferredSize и возвращает это значение.

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

getMaximumSize в классе ComponentUI

Параметры:

c - компонент, максимальный размер которого запрашивается; этот аргумент часто игнорируется, но может использоваться, если объект UI является бессостоятельным и используется несколькими компонентами

Возвращает:

объект Dimension или null

См. также:

JComponent.getMaximumSize(), LayoutManager2.maximumLayoutSize(java.awt.Container)

getBaseline

public int getBaseline(JComponent c,
                       int width,
                       int height)

Возвращает базу.

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

getBaseline в классе ComponentUI

Параметры:

c - JComponent база запрашивается для

width - ширина для получения базы

height - высота для получения базы

Возвращает:

базу или значение < 0, указывающее, что разумной базы нет

Исключения:

NullPointerException - если c является null

IllegalArgumentException - если ширина или высота < 0

С тех пор как:

1.6

См. также:

JComponent.getBaseline(int, int)

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)

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

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

getBaselineResizeBehavior в классе ComponentUI

Параметры:

c - JComponent для возврата поведения изменения размера базы

Возвращает:

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

Исключения:

NullPointerException - если c является null

С тех пор как:

1.6

См. также:

JComponent.getBaseline(int, int)

getAccessibleChildrenCount

public int getAccessibleChildrenCount(JComponent c)

Описание скопировано из класса: ComponentUI

Возвращает количество доступных дочерних элементов в объекте. Если все дочерние элементы этого объекта реализуют Accessible, этот метод должен возвращать количество дочерних элементов этого объекта. Интерфейсы могут переопределить этот метод, если они представляют области на экране, которые могут быть отображены как компоненты, но фактические компоненты не используются для представления этих областей. Примечание: начиная с версии 1.3, рекомендуется использовать метод Component.AccessibleAWTComponent.getAccessibleChildrenCount() вместо этого метода.

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

getAccessibleChildrenCount в классе ComponentUI

Возвращает:

количество доступных дочерних элементов в объекте

См. также:

ComponentUI.getAccessibleChild(javax.swing.JComponent, int)

getAccessibleChild

public Accessible getAccessibleChild(JComponent c,
                                     int i)

Описание скопировано из класса: ComponentUI

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

getAccessibleChild в классе ComponentUI

i - индекс дочернего элемента (от 0)

Возвращает:

i-й Accessible дочерний элемент объекта

См. также:

ComponentUI.getAccessibleChildrenCount(javax.swing.JComponent)

isNavigationKey

protected boolean isNavigationKey(int keyCode)

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

selectNextPossibleValue

protected void selectNextPossibleValue()

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

selectPreviousPossibleValue

protected void selectPreviousPossibleValue()

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

toggleOpenClose

protected void toggleOpenClose()

Скрывает всплывающее окно, если оно отображается, и отображает всплывающее окно, если оно скрыто.

rectangleForCurrentValue

protected Rectangle rectangleForCurrentValue()

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

getInsets

protected Insets getInsets()

Получает отступы из JComboBox.

paintCurrentValue

public void paintCurrentValue(Graphics g,
                              Rectangle bounds,
                              boolean hasFocus)

Отрисовывает текущий выбранный элемент.

paintCurrentValueBackground

public void paintCurrentValueBackground(Graphics g,
                                        Rectangle bounds,
                                        boolean hasFocus)

Отрисовывает фон текущего выбранного элемента.

getDefaultSize

protected Dimension getDefaultSize()

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

Возвращает:

размер пустой области отображения

См. также:

getDisplaySize()

getDisplaySize

protected Dimension getDisplaySize()

Возвращает:

размер области отображения, рассчитанный из элементов раскрывающегося списка

См. также:

JComboBox.setPrototypeDisplayValue(E)

getSizeForComponent

protected Dimension getSizeForComponent(Component comp)

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

Параметры:

comp - компонент для проверки

Возвращает:

размер компонента

С:

1.7

installKeyboardActions

protected void installKeyboardActions()

Добавляет действия клавиш к JComboBox. Действия при нажатии Enter и Esc уже предоставлены. Добавьте дополнительные действия по мере необходимости.

uninstallKeyboardActions

protected void uninstallKeyboardActions()

Удаляет InputMap и ActionMap фокуса.