Класс JComboBox<E>

javax.swing.JComboBox<E>

Type Parameters:: E - тип элементов этого выпадающего списка

Все реализованные интерфейсы:: ActionListener, ImageObserver, ItemSelectable, MenuContainer, Serializable, EventListener, Accessible, ListDataListener

@JavaBean(defaultProperty="UI", description="A combination of a text field and a drop-down list.") public class JComboBox<E> extends JComponent implements ItemSelectable, ListDataListener, ActionListener, Accessible

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

Предупреждение: Swing не потокобезопасен. Для получения дополнительной информации см. Политику потоков Swing.

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

См. Как использовать выпадающие списки в Руководстве по Java для получения дополнительной информации.

Since:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`JComboBox.AccessibleJComboBox`	Этот класс реализует поддержку доступности для класса `JComboBox`.
`static interface`	`JComboBox.KeySelectionManager`	Интерфейс, определяющий выпадающий список.

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

Модификатор и тип	Поле	Описание
`protected String`	`actionCommand`	Это защищенное поле является специфичным для реализации.
`protected ComboBoxModel<E>`	`dataModel`	Это защищенное поле является специфичным для реализации.
`protected ComboBoxEditor`	`editor`	Это защищенное поле является специфичным для реализации.
`protected boolean`	`isEditable`	Это защищенное поле является специфичным для реализации.
`protected JComboBox.KeySelectionManager`	`keySelectionManager`	Это защищенное поле является специфичным для реализации.
`protected boolean`	`lightWeightPopupEnabled`	Это защищенное поле является специфичным для реализации.
`protected int`	`maximumRowCount`	Это защищенное поле является специфичным для реализации.
`protected ListCellRenderer<? super E>`	`renderer`	Это защищенное поле является специфичным для реализации.
`protected Object`	`selectedItemReminder`	Это защищенное поле является специфичным для реализации.

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

Конструктор	Описание
`JComboBox()`	Создает выпадающий список с моделью данных по умолчанию.
`JComboBox(E[] items)`	Создает выпадающий список, содержащий элементы в заданном массиве.
`JComboBox(Vector<E> items)`	Создает выпадающий список, содержащий элементы в заданном Vector.
`JComboBox(ComboBoxModel<E> aModel)`	Создает выпадающий список, получающий свои элементы из существующего выпадающего списка.

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

Модификатор и тип	Метод	Описание
`void`	`actionPerformed(ActionEvent e)`	Этот метод является общедоступным как побочный эффект реализации.
`protected void`	`actionPropertyChanged(Action action, String propertyName)`	Обновляет состояние раскрывающегося списка в ответ на изменения свойств в связанном действии.
`void`	`addActionListener(ActionListener l)`	Добавляет `ActionListener`.
`void`	`addItem(E item)`	Добавляет элемент в список элементов.
`void`	`addItemListener(ItemListener aListener)`	Добавляет `ItemListener`.
`void`	`addPopupMenuListener(PopupMenuListener l)`	Добавляет слушателя `PopupMenu`, который будет прослушивать сообщения о уведомлениях из всплывающей части раскрывающегося списка.
`void`	`configureEditor(ComboBoxEditor anEditor, Object anItem)`	Инициализирует редактор указанным элементом.
`protected void`	`configurePropertiesFromAction(Action a)`	Устанавливает свойства этого раскрывающегося списка в соответствии со свойствами в указанном `Action`.
`void`	`contentsChanged(ListDataEvent e)`	Этот метод является общедоступным как побочный эффект реализации.
`protected PropertyChangeListener`	`createActionPropertyChangeListener(Action a)`	Создает и возвращает `PropertyChangeListener`, который отвечает за прослушивание изменений от указанного `Action` и обновление соответствующих свойств.
`protected JComboBox.KeySelectionManager`	`createDefaultKeySelectionManager()`	Возвращает экземпляр менеджера выбора по умолчанию.
`protected void`	`fireActionEvent()`	Уведомляет всех слушателей, которые зарегистрировали интерес к получению уведомлений об этом типе события.
`protected void`	`fireItemStateChanged(ItemEvent e)`	Уведомляет всех слушателей, которые зарегистрировали интерес к получению уведомлений об этом типе события.
`void`	`firePopupMenuCanceled()`	Уведомляет `PopupMenuListener`, что всплывающая часть раскрывающегося списка была отменена.
`void`	`firePopupMenuWillBecomeInvisible()`	Уведомляет `PopupMenuListener`, что всплывающая часть раскрывающегося списка стала невидимой.
`void`	`firePopupMenuWillBecomeVisible()`	Уведомляет `PopupMenuListener`, что всплывающая часть раскрывающегося списка станет видимой.
`AccessibleContext`	`getAccessibleContext()`	Получает AccessibleContext, связанный с этим JComboBox.
`Action`	`getAction()`	Возвращает текущее значение `Action` для этого источника `ActionEvent`, или `null`, если значение `Action` не установлено.
`String`	`getActionCommand()`	Возвращает команду действия, которая включена в событие, отправленное слушателям действий.
`ActionListener[]`	`getActionListeners()`	Возвращает массив всех `ActionListener`ов, добавленных в этот JComboBox с addActionListener().
`ComboBoxEditor`	`getEditor()`	Возвращает редактор, используемый для отрисовки и редактирования выбранного элемента в поле `JComboBox`.
`E`	`getItemAt(int index)`	Возвращает элемент списка по указанному индексу.
`int`	`getItemCount()`	Возвращает количество элементов в списке.
`ItemListener[]`	`getItemListeners()`	Возвращает массив всех `ItemListener`ов, добавленных в этот JComboBox с addItemListener().
`JComboBox.KeySelectionManager`	`getKeySelectionManager()`	Возвращает менеджер выбора по ключу списка.
`int`	`getMaximumRowCount()`	Возвращает максимальное количество элементов, которое может отобразить раскрывающийся список без полосы прокрутки.
`ComboBoxModel<E>`	`getModel()`	Возвращает модель данных, которая в данный момент используется `JComboBox`.
`PopupMenuListener[]`	`getPopupMenuListeners()`	Возвращает массив всех `PopupMenuListener`ов, добавленных в этот JComboBox с addPopupMenuListener().
`E`	`getPrototypeDisplayValue()`	Возвращает значение "прототипического отображения" - объект, используемый для расчета высоты и ширины отображения.
`ListCellRenderer<? super E>`	`getRenderer()`	Возвращает рендерер, используемый для отображения выбранного элемента в поле `JComboBox`.
`int`	`getSelectedIndex()`	Возвращает первый элемент в списке, соответствующий заданному элементу.
`Object`	`getSelectedItem()`	Возвращает текущий выбранный элемент.
`Object[]`	`getSelectedObjects()`	Возвращает массив, содержащий выбранный элемент.
`ComboBoxUI`	`getUI()`	Возвращает объект L&F, который отрисовывает этот компонент.
`String`	`getUIClassID()`	Возвращает имя класса L&F, который отрисовывает этот компонент.
`void`	`hidePopup()`	Закрывает всплывающее окно раскрывающегося списка.
`void`	`insertItemAt(E item, int index)`	Вставляет элемент в список элементов по заданному индексу.
`protected void`	`installAncestorListener()`	Регистрирует слушателя предков, чтобы он получал `AncestorEvents` при перемещении его или любого из его предков, или при изменении видимости.
`void`	`intervalAdded(ListDataEvent e)`	Этот метод является общедоступным как побочный эффект реализации.
`void`	`intervalRemoved(ListDataEvent e)`	Этот метод является общедоступным как побочный эффект реализации.
`boolean`	`isEditable()`	Возвращает true, если `JComboBox` редактируемый.
`boolean`	`isLightWeightPopupEnabled()`	Получает значение свойства `lightWeightPopupEnabled`.
`boolean`	`isPopupVisible()`	Определяет видимость всплывающего окна.
`protected String`	`paramString()`	Возвращает строковое представление этого `JComboBox`.
`void`	`processKeyEvent(KeyEvent e)`	Обрабатывает `KeyEvent`ы, ища клавишу Tab.
`void`	`removeActionListener(ActionListener l)`	Удаляет `ActionListener`.
`void`	`removeAllItems()`	Удаляет все элементы из списка элементов.
`void`	`removeItem(Object anObject)`	Удаляет элемент из списка элементов.
`void`	`removeItemAt(int anIndex)`	Удаляет элемент по `anIndex`. Этот метод работает только в том случае, если `JComboBox` использует изменяемую модель данных.
`void`	`removeItemListener(ItemListener aListener)`	Удаляет `ItemListener`.
`void`	`removePopupMenuListener(PopupMenuListener l)`	Удаляет `PopupMenuListener`.
`protected void`	`selectedItemChanged()`	Этот защищенный метод является специфичным для реализации.
`boolean`	`selectWithKeyChar(char keyChar)`	Выбирает элемент списка, соответствующий заданному символу клавиатуры, и возвращает true, если есть элемент, соответствующий этому символу.
`void`	`setAction(Action a)`	Устанавливает `Action` для источника `ActionEvent`.
`void`	`setActionCommand(String aCommand)`	Устанавливает команду действия, которая должна быть включена в событие, отправленное слушателям действий.
`void`	`setEditable(boolean aFlag)`	Определяет, является ли поле `JComboBox` редактируемым.
`void`	`setEditor(ComboBoxEditor anEditor)`	Устанавливает редактор, используемый для отрисовки и редактирования выбранного элемента в поле `JComboBox`.
`void`	`setEnabled(boolean b)`	Включает раскрывающийся список, чтобы можно было выбирать элементы.
`void`	`setKeySelectionManager(JComboBox.KeySelectionManager aManager)`	Устанавливает объект, который преобразует символ клавиатуры в выбор элемента списка.

`void`	`setLightWeightPopupEnabled(boolean aFlag)`	Устанавливает свойство `lightWeightPopupEnabled`, которое указывает, следует ли использовать лёгкую `Component` оболочку для `JComboBox`, или тяжёлую `Component`, например `Panel` или `Window`.
`void`	`setMaximumRowCount(int count)`	Устанавливает максимальное количество строк, отображаемых `JComboBox`.
`void`	`setModel(ComboBoxModel<E> aModel)`	Устанавливает модель данных, используемую `JComboBox` для получения списка элементов.
`void`	`setPopupVisible(boolean v)`	Устанавливает видимость всплывающего окна.
`void`	`setPrototypeDisplayValue(E prototypeDisplayValue)`	Устанавливает значение отображения прототипа, используемое для расчёта размера отображения пользовательского интерфейса.
`void`	`setRenderer(ListCellRenderer<? super E> aRenderer)`	Устанавливает рендерер, который отрисовывает элементы списка и выделенный элемент списка в поле JComboBox.
`void`	`setSelectedIndex(int anIndex)`	Выбирает элемент по индексу `anIndex`.
`void`	`setSelectedItem(Object anObject)`	Устанавливает выбранный элемент в области отображения выпадающего списка на объект в аргументе.
`void`	`setUI(ComboBoxUI ui)`	Устанавливает объект L&F, который отрисовывает этот компонент.
`void`	`showPopup()`	Приводит к отображению всплывающего окна выпадающего списка.
`void`	`updateUI()`	Сбрасывает свойство пользовательского интерфейса на значение из текущей темы оформления.

Методы, объявленные в классе javax.swing.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, 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, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

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

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

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

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

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

dataModel

protected ComboBoxModel<E> dataModel

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

См. также:

getModel()
setModel(javax.swing.ComboBoxModel<E>)

renderer

protected ListCellRenderer<? super E> renderer

См. также:

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

editor

protected ComboBoxEditor editor

См. также:

getEditor()
setEditor(javax.swing.ComboBoxEditor)

maximumRowCount

protected int maximumRowCount

См. также:

getMaximumRowCount()
setMaximumRowCount(int)

isEditable

protected boolean isEditable

См. также:

isEditable
setEditable(boolean)

keySelectionManager

protected JComboBox.KeySelectionManager keySelectionManager

См. также:

setKeySelectionManager(javax.swing.JComboBox.KeySelectionManager)
getKeySelectionManager()

actionCommand

protected String actionCommand

См. также:

setActionCommand(java.lang.String)
getActionCommand()

lightWeightPopupEnabled

protected boolean lightWeightPopupEnabled

См. также:

setLightWeightPopupEnabled(boolean)
isLightWeightPopupEnabled()

selectedItemReminder

protected Object selectedItemReminder

Это защищённое поле, специфичное для реализации. Не обращайтесь к нему напрямую и не переопределяйте.

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

JComboBox

public JComboBox(ComboBoxModel<E> aModel)

Создаёт JComboBox, который получает свои элементы из существующего ComboBoxModel. Поскольку ComboBoxModel предоставлен, созданный с помощью этого конструктора компонент combo box не создаёт модель combo box по умолчанию и может повлиять на поведение методов insert, remove и add.

Параметры:

aModel - ComboBoxModel, предоставляющий отображаемый список элементов

См. также:

DefaultComboBoxModel

JComboBox

public JComboBox(E[] items)

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

Параметры:

items - массив объектов для вставки в combo box

См. также:

DefaultComboBoxModel

JComboBox

public JComboBox(Vector<E> items)

Создаёт JComboBox, содержащий элементы в указанном Vector. По умолчанию первым выбранным элементом становится первый элемент в векторе (и, следовательно, в модели данных).

Параметры:

items - массив векторов для вставки в combo box

См. также:

DefaultComboBoxModel

JComboBox

public JComboBox()

Создаёт JComboBox с моделью данных по умолчанию. Модель данных по умолчанию — пустой список объектов. Используйте addItem для добавления элементов. По умолчанию первым выбранным элементом становится первый элемент в модели данных.

См. также:

DefaultComboBoxModel

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

installAncestorListener

protected void installAncestorListener()

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

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component\'s LookAndFeel.") public void setUI(ComboBoxUI ui)

Устанавливает объект L&F, который отрисовывает этот компонент.

Параметры:

ui - объект L&F ComboBoxUI

См. также:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

Сбрасывает свойство UI на значение из текущей темы оформления.

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

updateUI в классе JComponent

См. также:

JComponent.updateUI()

getUIClassID

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

Возвращает имя класса L&F, который отрисовывает этот компонент.

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

getUIClassID в классе JComponent

Возвращает:

строку "ComboBoxUI"

См. также:

getUI

public ComboBoxUI getUI()

Возвращает объект L&F, который отрисовывает этот компонент.

Переопределяет:: getUI в классе JComponent
Возвращает:: объект ComboBoxUI, который отрисовывает этот компонент

setModel

@BeanProperty(description="Model that the combo box uses to get data to display.") public void setModel(ComboBoxModel<E> aModel)

Устанавливает модель данных, которую JComboBox использует для получения списка элементов.

Параметры:: aModel - ComboBoxModel предоставляющий отображаемый список элементов

getModel

public ComboBoxModel<E> getModel()

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

Возвращает:: ComboBoxModel предоставляющий отображаемый список элементов

setLightWeightPopupEnabled

@BeanProperty(expert=true, description="Set to <code>false</code> to require heavyweight popups.") public void setLightWeightPopupEnabled(boolean aFlag)

Устанавливает свойство lightWeightPopupEnabled, которое даёт подсказку о том, следует ли использовать лёгкий Component для размещения JComboBox, или тяжёлый Component , такой как Panel или Window . Решение о лёгком или тяжёлом варианте в конечном счёте принимает JComboBox. Лёгкие окна более эффективны, чем тяжёлые, но лёгкие и тяжёлые компоненты не смешиваются хорошо в пользовательском интерфейсе. Если ваше приложение смешивает лёгкие и тяжёлые компоненты, следует отключить лёгкие всплывающие окна. Значение по умолчанию для свойства lightWeightPopupEnabled — true, если не указано иначе в настройках темы оформления. Некоторые темы оформления всегда используют тяжёлые всплывающие окна, независимо от значения этого свойства.

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

Параметры:: aFlag - если true, желательно использовать лёгкие всплывающие окна

isLightWeightPopupEnabled

public boolean isLightWeightPopupEnabled()

Получает значение свойства lightWeightPopupEnabled.

Возвращает:

значение свойства lightWeightPopupEnabled

См. также:

setLightWeightPopupEnabled(boolean)

setEditable

@BeanProperty(preferred=true, description="If true, the user can type a new value in the combo box.") public void setEditable(boolean aFlag)

Определяет, является ли поле JComboBox редактируемым. Редактируемое поле JComboBox позволяет пользователю вводить текст в поле или выбирать элемент из списка для инициализации поля, после чего оно может быть отредактировано. (Редактирование затрагивает только поле, элемент списка остается неизменным.) Нередактируемое поле JComboBox отображает выбранный элемент в поле, но выбор изменить нельзя.

Parameters:: aFlag - логическое значение, где true указывает, что поле редактируемое

isEditable

public boolean isEditable()

Возвращает true, если JComboBox редактируемо. По умолчанию, раскрывающийся список не редактируем.

Returns:: true, если JComboBox редактируемо, иначе false

setMaximumRowCount

@BeanProperty(preferred=true, description="The maximum number of rows the popup should have") public void setMaximumRowCount(int count)

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

Parameters:: count - целое число, определяющее максимальное количество элементов, отображаемых в списке перед использованием полосы прокрутки

getMaximumRowCount

public int getMaximumRowCount()

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

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

setRenderer

@BeanProperty(expert=true, description="The renderer that paints the item selected in the list.") public void setRenderer(ListCellRenderer<? super E> aRenderer)

Устанавливает визуализатор, который отрисовывает элементы списка и выбранный из списка элемент в поле JComboBox. Визуализатор используется, если JComboBox не редактируемый. Если он редактируемый, используется редактор для отрисовки и редактирования выбранного элемента.

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

Для отображения выбранного элемента вызывается aRenderer.getListCellRendererComponent, передавая объект списка и индекс -1.

Parameters:

aRenderer - визуализатор, который отображает выбранный элемент

See Also:

setEditor(javax.swing.ComboBoxEditor)

getRenderer

public ListCellRenderer<? super E> getRenderer()

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

Returns:: визуализатор, который отображает выбранный элемент.

setEditor

@BeanProperty(expert=true, description="The editor that combo box uses to edit the current value") public void setEditor(ComboBoxEditor anEditor)

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

Parameters:

anEditor - редактор, который отображает выбранный элемент

See Also:

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

getEditor

public ComboBoxEditor getEditor()

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

Returns:: редактор, который отображает выбранный элемент

setSelectedItem

@BeanProperty(bound=false, preferred=true, description="Sets the selected item in the JComboBox.") public void setSelectedItem(Object anObject)

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

Если anObject не находится в списке и раскрывающийся список не редактируемый, текущий выбор не изменится. Для редактируемых раскрывающихся списков выбор изменится на anObject.

Если это изменение выбранного элемента, ItemListener добавленные в раскрывающийся список будут уведомлены с одним или двумя ItemEvent. Если есть текущий выбранный элемент, будет вызвано ItemEvent, и изменение состояния будет ItemEvent.DESELECTED. Если anObject находится в списке и не выбран, то будет вызвано ItemEvent, и изменение состояния будет ItemEvent.SELECTED.

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

Parameters:: anObject - объект списка для выбора; используйте null для очистки выбора

getSelectedItem

public Object getSelectedItem()

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

Если раскрывающийся список редактируемый, то это значение может не быть добавлено в раскрывающийся список с помощью addItem, insertItemAt или конструкторов данных.

Returns:

текущий выбранный Объект

See Also:

setSelectedItem(java.lang.Object)

setSelectedIndex

@BeanProperty(bound=false, preferred=true, description="The item at index is selected.") public void setSelectedIndex(int anIndex)

Выбирает элемент с индексом anIndex.

Parameters:: anIndex - целое число, определяющее элемент списка для выбора, где 0 определяет первый элемент в списке, а -1 означает отсутствие выбора
Throws:: IllegalArgumentException - если anIndex < -1 или anIndex больше или равно размеру

getSelectedIndex

public int getSelectedIndex()

Возвращает первый элемент в списке, который соответствует заданному элементу. Результат не всегда определен, если JComboBox разрешает выбранные элементы, которые не находятся в списке. Возвращает -1, если нет выбранного элемента или если пользователь указал элемент, который не находится в списке.

Returns:: целое число, определяющее текущий выбранный элемент списка, где 0 определяет первый элемент в списке; или -1, если нет выбранного элемента или если текущий выбранный элемент не находится в списке

getPrototypeDisplayValue

public E getPrototypeDisplayValue()

Возвращает значение "прототипичного отображения" - объекта, используемого для расчета высоты и ширины отображения.

Returns:

значение свойства prototypeDisplayValue

Since:

1.4

See Also:

setPrototypeDisplayValue(E)

setPrototypeDisplayValue

@BeanProperty(visualUpdate=true, description="The display prototype value, used to compute display width and height.") public void setPrototypeDisplayValue(E prototypeDisplayValue)

Устанавливает значение прототипа отображения, используемое для расчета размера отображения для пользовательского интерфейса.

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

Parameters:

prototypeDisplayValue - значение прототипа отображения

Since:

1.4

See Also:

getPrototypeDisplayValue()

addItem

public void addItem(E item)

Добавляет элемент в список элементов. Этот метод работает только если JComboBox использует изменяемую модель данных.

Предупреждение: Возможны проблемы с фокусом и навигацией по клавиатуре, если вы добавляете дублирующиеся строковые объекты. Обходной путь заключается в добавлении новых объектов вместо строковых объектов и обеспечении того, что метод toString() определен. Например:

   comboBox.addItem(makeObj("Item 1"));
   comboBox.addItem(makeObj("Item 1"));
   ...
   private Object makeObj(final String item)  {
     return new Object() { public String toString() { return item; } };
   }

Parameters:

item - элемент для добавления в список

See Also:

MutableComboBoxModel

insertItemAt

public void insertItemAt(E item, int index)

Вставляет элемент в список элементов по заданному индексу. Этот метод работает только если JComboBox использует изменяемую модель данных.

Parameters:

item - элемент для добавления в список

index - целое число, определяющее позицию для добавления элемента

See Also:

MutableComboBoxModel

removeItem

public void removeItem(Object anObject)

Удаляет элемент из списка элементов. Этот метод работает только если JComboBox использует изменяемую модель данных.

Parameters:

anObject - объект для удаления из списка элементов

See Also:

MutableComboBoxModel

removeItemAt

public void removeItemAt(int anIndex)

Удаляет элемент по anIndex. Этот метод работает только если JComboBox использует изменяемую модель данных.

Parameters:

anIndex - целое число, определяющее индекс удаляемого элемента, где 0 указывает на первый элемент в списке

See Also:

MutableComboBoxModel

removeAllItems

public void removeAllItems()

Удаляет все элементы из списка.

showPopup

public void showPopup()

Приводит к отображению всплывающего окна раскрывающегося списка.

См. также:

setPopupVisible(boolean)

hidePopup

public void hidePopup()

Приводит к закрытию всплывающего окна раскрывающегося списка.

См. также:

setPopupVisible(boolean)

setPopupVisible

public void setPopupVisible(boolean v)

Устанавливает видимость всплывающего окна.

Параметры:: v - если true отображает всплывающее окно, в противном случае скрывает всплывающее окно.

isPopupVisible

public boolean isPopupVisible()

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

Возвращает:: true, если всплывающее окно видимое, в противном случае возвращает false

addItemListener

public void addItemListener(ItemListener aListener)

Добавляет слушателя изменения выбранного элемента.

Слушатель ItemListener получит один или два события ItemEvent при изменении выбранного элемента.

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

addItemListener в интерфейсе ItemSelectable

Параметры:

aListener - слушатель ItemListener

См. также:

setSelectedItem(java.lang.Object)

removeItemListener

public void removeItemListener(ItemListener aListener)

Удаляет слушателя изменения выбранного элемента.

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

removeItemListener в интерфейсе ItemSelectable

Параметры:

aListener - слушатель ItemListener для удаления

См. также:

ItemEvent

getItemListeners

@BeanProperty(bound=false) public ItemListener[] getItemListeners()

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

Возвращает:: все добавленные слушатели или пустой массив, если слушатели не добавлены
С тех пор:: 1.4

addActionListener

public void addActionListener(ActionListener l)

Добавляет слушателя событий.

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

Параметры:

l - слушатель ActionListener

См. также:

setSelectedItem(java.lang.Object)

removeActionListener

public void removeActionListener(ActionListener l)

Удаляет слушателя событий.

Параметры:: l - слушатель ActionListener для удаления

getActionListeners

@BeanProperty(bound=false) public ActionListener[] getActionListeners()

Возвращает массив всех слушателей событий, добавленных с помощью addActionListener().

Возвращает:: все добавленные слушатели или пустой массив, если слушатели не добавлены
С тех пор:: 1.4

addPopupMenuListener

public void addPopupMenuListener(PopupMenuListener l)

Добавляет слушателя событий всплывающего меню раскрывающегося списка.

Для всех стандартных стилей отрисовки, поставляемых с Java, часть всплывающего списка раскрывающегося списка реализуется как JPopupMenu. Пользовательский стиль отрисовки может не реализовывать это таким образом и, следовательно, не получит уведомление.

Параметры:: l - слушатель PopupMenuListener
С тех пор:: 1.4

removePopupMenuListener

public void removePopupMenuListener(PopupMenuListener l)

Удаляет слушателя событий всплывающего меню.

Параметры:

l - слушатель PopupMenuListener для удаления

С тех пор:

1.4

См. также:

addPopupMenuListener(javax.swing.event.PopupMenuListener)

getPopupMenuListeners

@BeanProperty(bound=false) public PopupMenuListener[] getPopupMenuListeners()

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

Возвращает:: все добавленные слушатели или пустой массив, если слушатели не добавлены
С тех пор:: 1.4

firePopupMenuWillBecomeVisible

public void firePopupMenuWillBecomeVisible()

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

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

С тех пор:

1.4

См. также:

addPopupMenuListener(javax.swing.event.PopupMenuListener)

firePopupMenuWillBecomeInvisible

public void firePopupMenuWillBecomeInvisible()

Уведомляет слушателей, что всплывающее меню станет невидимым.

С тех пор:

1.4

См. также:

addPopupMenuListener(javax.swing.event.PopupMenuListener)

firePopupMenuCanceled

public void firePopupMenuCanceled()

Уведомляет слушателей, что всплывающее меню было отменено.

С тех пор:

1.4

См. также:

addPopupMenuListener(javax.swing.event.PopupMenuListener)

setActionCommand

public void setActionCommand(String aCommand)

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

Параметры:: aCommand - строка, содержащая "команду", которая отправляется слушателям действий; один и тот же слушатель может затем выполнять разные действия в зависимости от полученной команды

getActionCommand

public String getActionCommand()

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

Возвращает:: строка, содержащая "команду", которая отправляется слушателям действий.

setAction

@BeanProperty(visualUpdate=true, description="the Action instance connected with this ActionEvent source") public void setAction(Action a)

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

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

Этот метод использует три других метода для установки и отслеживания значений свойств действия. Он использует метод configurePropertiesFromAction для немедленного изменения свойств раскрывающегося списка. Для отслеживания изменений в значениях свойств действия этот метод регистрирует слушатель изменений свойств, возвращаемый createActionPropertyChangeListener. По умолчанию слушатель изменений свойств вызывает метод actionPropertyChanged при изменении свойства в действии.

Параметры:

a - действие для источника, или null.

С тех пор:

1.3

См. также:

Action
getAction()
configurePropertiesFromAction(javax.swing.Action)
createActionPropertyChangeListener(javax.swing.Action)
actionPropertyChanged(javax.swing.Action, java.lang.String)

getAction

public Action getAction()

Возвращает текущее установленное действие для этого источника, или null, если действие не установлено.

Возвращает:

действие для этого источника; или null

С тех пор:

1.3

См. также:

Action
setAction(javax.swing.Action)

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)

Устанавливает свойства этого списка в соответствии со свойствами указанного Action. Обратитесь к Swing-компонентам, поддерживающим Action для получения дополнительной информации о том, какие свойства устанавливаются.

Parameters:

a - the Action из которого берутся свойства, или null

Since:

1.3

See Also:

Action
setAction(javax.swing.Action)

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)

Создаёт и возвращает PropertyChangeListener, который отвечает за прослушивание изменений от указанного Action и обновление соответствующих свойств.

Предупреждение: Если вы создаёте подкласс, не создавайте анонимный внутренний класс. В противном случае срок существования combobox будет привязан к сроку существования Action.

Parameters:

a - action combobox

Returns:

the PropertyChangeListener

Since:

1.3

See Also:

Action
setAction(javax.swing.Action)

actionPropertyChanged

protected void actionPropertyChanged(Action action, String propertyName)

Обновляет состояние combobox в ответ на изменения свойств в связанном действии. Этот метод вызывается из PropertyChangeListener возвращаемого createActionPropertyChangeListener. Подклассы обычно не должны вызывать это. Подклассы, поддерживающие дополнительные Action свойства, должны переопределить этот метод и configurePropertiesFromAction.

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

Parameters:

action - the Action связанный с этим combobox

propertyName - имя свойства, которое изменилось

Since:

1.6

See Also:

Action
configurePropertiesFromAction(javax.swing.Action)

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)

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

Parameters:

e - событие, представляющее интерес

See Also:

EventListenerList

fireActionEvent

protected void fireActionEvent()

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

See Also:

EventListenerList

selectedItemChanged

protected void selectedItemChanged()

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

getSelectedObjects

@BeanProperty(bound=false) public Object[] getSelectedObjects()

Возвращает массив, содержащий выбранный элемент. Этот метод реализован для совместимости с ItemSelectable.

Specified by:: getSelectedObjects in interface ItemSelectable
Returns:: an array of Objects содержащий один элемент — выбранный элемент

actionPerformed

public void actionPerformed(ActionEvent e)

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

Specified by:: actionPerformed in interface ActionListener
Parameters:: e - событие, подлежащее обработке

contentsChanged

public void contentsChanged(ListDataEvent e)

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

Specified by:: contentsChanged in interface ListDataListener
Parameters:: e - a ListDataEvent encapsulating the event information

intervalAdded

public void intervalAdded(ListDataEvent e)

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

Specified by:: intervalAdded in interface ListDataListener
Parameters:: e - a ListDataEvent encapsulating the event information

intervalRemoved

public void intervalRemoved(ListDataEvent e)

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

Specified by:: intervalRemoved in interface ListDataListener
Parameters:: e - a ListDataEvent encapsulating the event information

selectWithKeyChar

public boolean selectWithKeyChar(char keyChar)

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

Parameters:: keyChar - символ, обычно это нажатая пользователем клавиша клавиатуры
Returns:: true если существует элемент, соответствующий этому символу. В противном случае возвращает false.

setEnabled

@BeanProperty(preferred=true, description="The enabled state of the component.") public void setEnabled(boolean b)

Включает список, так что элементы могут быть выбраны. Когда список отключён, элементы не могут быть выбраны, а значения не могут быть введены в его поле (если оно редактируемо).

Overrides:

setEnabled in class JComponent

Parameters:

b - значение boolean, где true включает компонент, а false отключает его

See Also:

configureEditor

public void configureEditor(ComboBoxEditor anEditor, Object anItem)

Инициализирует редактор указанным элементом.

Parameters:: anEditor - the ComboBoxEditor, which displays the list item in the combo box field and allows it to be edited; anItem - объект, который отображается и редактируется в поле

processKeyEvent

public void processKeyEvent(KeyEvent e)

Обрабатывает KeyEvent, проверяя нажатие клавиши Tab. Если найдена клавиша Tab, раскрывающееся окно закрывается.

Overrides:

processKeyEvent in class JComponent

Parameters:

e - the KeyEvent containing the keyboard key that was pressed

See Also:

setKeySelectionManager

@BeanProperty(bound=false, expert=true, description="The objects that changes the selection when a key is pressed.") public void setKeySelectionManager(JComboBox.KeySelectionManager aManager)

Устанавливает объект, который преобразует символ клавиатуры в выбор в списке. Обычно, первый выбор с соответствующим первым символом становится выбранным элементом.

Parameters:: aManager - менеджер выбора по ключу

getKeySelectionManager

public JComboBox.KeySelectionManager getKeySelectionManager()

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

Returns:: the KeySelectionManager currently in use

getItemCount

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

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

Returns:: целое число, равное количеству элементов в списке

getItemAt

public E getItemAt(int index)

Возвращает элемент списка по указанному индексу. Если index находится вне диапазона (меньше нуля или больше или равно размеру), будет возвращено null.

Parameters:: index - целое число, указывающее позицию в списке, где первый элемент начинается с нуля
Returns:: элемент в данной позиции списка; или null если позиция вне диапазона

END_OF_DOCUMENT_MARKER

createDefaultKeySelectionManager

protected JComboBox.KeySelectionManager createDefaultKeySelectionManager()

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

Returns:

the KeySelectionManager, используемый в настоящее время в списке

См. также:

setKeySelectionManager(javax.swing.JComboBox.KeySelectionManager)

paramString

protected String paramString()

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

Overrides:: paramString в классе JComponent
Returns:: строковое представление этого JComboBox

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим JComboBox. Для раскрывающихся списков AccessibleContext принимает форму AccessibleJComboBox. Новый экземпляр AccessibleJComboBox создается при необходимости.

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Returns:: AccessibleJComboBox, используемый в качестве AccessibleContext этого JComboBox

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