Класс JComboBox<E>

javax.swing.JComboBox<E>

Параметры типа:: 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 Tutorial для получения дополнительной информации.

С:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`JComboBox.AccessibleJComboBox`	Этот класс реализует поддержку доступности для класса `JComboBox`.
`static interface`	`JComboBox.KeySelectionManager`	Интерфейс, определяющий `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` с моделью данных по умолчанию.
`JComboBox(E[] items)`	Создаёт `JComboBox`, содержащий элементы в указанном массиве.
`JComboBox(Vector<E> items)`	Создаёт `JComboBox`, содержащий элементы в указанном векторе.
`JComboBox(ComboBoxModel<E> aModel)`	Создаёт `JComboBox`, который берёт свои элементы из существующего `ComboBoxModel`.

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

Модификатор и тип	Метод	Описание
`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)`	Устанавливает объект, который преобразует символ клавиатуры в выбор элемента списка.

END_OF_DOCUMENT_MARKER

`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

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

См. также:

renderer

protected ListCellRenderer<? super E> renderer

См. также:

editor

protected ComboBoxEditor editor

См. также:

maximumRowCount

protected int maximumRowCount

См. также:

isEditable

protected boolean isEditable

См. также:

keySelectionManager

protected JComboBox.KeySelectionManager keySelectionManager

См. также:

actionCommand

protected String actionCommand

См. также:

lightWeightPopupEnabled

protected boolean lightWeightPopupEnabled

См. также:

selectedItemReminder

protected Object selectedItemReminder

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

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

JComboBox

public JComboBox(ComboBoxModel<E> aModel)

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

Параметры:

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

См. также:

JComboBox

public JComboBox(E[] items)

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

Параметры:

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

См. также:

JComboBox

public JComboBox(Vector<E> items)

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

Параметры:

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

См. также:

JComboBox

public JComboBox()

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

См. также:

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

installAncestorListener

protected void installAncestorListener()

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

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

См. также:

updateUI

public void updateUI()

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

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

updateUI в классе JComponent

См. также:

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

См. также:

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 отображает выбранный элемент в поле, но выбор изменить нельзя.

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

isEditable

public boolean isEditable()

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

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

setMaximumRowCount

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

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

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

getMaximumRowCount

public int getMaximumRowCount()

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

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

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.

Параметры:

aRenderer — ListCellRenderer, отображающий выбранный элемент

См. также:

getRenderer

public ListCellRenderer<? super E> getRenderer()

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

Возвращает:: ListCellRenderer, отображающий выбранный элемент.

setEditor

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

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

Параметры:

anEditor — ComboBoxEditor, отображающий выбранный элемент

См. также:

getEditor

public ComboBoxEditor getEditor()

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

Возвращает:: ComboBoxEditor, отображающий выбранный элемент

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 при вызове этого метода.

Параметры:: anObject — объект списка для выбора; использовать null для очистки выбора

getSelectedItem

public Object getSelectedItem()

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

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

Возвращает:

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

См. также:

setSelectedIndex

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

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

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

getSelectedIndex

public int getSelectedIndex()

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

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

getPrototypeDisplayValue

public E getPrototypeDisplayValue()

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

Возвращает:

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

С:

1.4

См. также:

setPrototypeDisplayValue

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

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

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

Параметры:

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

С:

1.4

См. также:

addItem

public void addItem(E item)

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

Предупреждение: Могут возникнуть проблемы с фокусом и навигацией по клавиатуре, если вы добавляете дублированные объекты String. Решение состоит в добавлении новых объектов вместо объектов String и обеспечении определения метода 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:

insertItemAt

public void insertItemAt(E item, int index)

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

Parameters:

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

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

See Also:

removeItem

public void removeItem(Object anObject)

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

Parameters:

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

See Also:

removeItemAt

public void removeItemAt(int anIndex)

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

Parameters:

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

See Also:

removeAllItems

public void removeAllItems()

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

showPopup

public void showPopup()

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

See Also:

hidePopup

public void hidePopup()

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

See Also:

setPopupVisible

public void setPopupVisible(boolean v)

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

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

isPopupVisible

public boolean isPopupVisible()

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

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

addItemListener

public void addItemListener(ItemListener aListener)

Добавляет слушателя ItemListener.

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

Specified by:

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

Parameters:

aListener - слушатель ItemListener, который должен быть уведомлён

See Also:

removeItemListener

public void removeItemListener(ItemListener aListener)

Удаляет слушателя ItemListener.

Specified by:

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

Parameters:

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

See Also:

getItemListeners

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

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

Returns:: все добавленные слушатели ItemListener или пустой массив, если слушатели не добавлены
Since:: 1.4

addActionListener

public void addActionListener(ActionListener l)

Добавляет слушателя ActionListener.

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

Parameters:

l - слушатель ActionListener, который должен быть уведомлён

See Also:

removeActionListener

public void removeActionListener(ActionListener l)

Удаляет слушателя ActionListener.

Parameters:: l - слушатель ActionListener для удаления

getActionListeners

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

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

Returns:: все добавленные слушатели ActionListener или пустой массив, если слушатели не добавлены
Since:: 1.4

addPopupMenuListener

public void addPopupMenuListener(PopupMenuListener l)

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

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

Parameters:: l - слушатель PopupMenuListener для добавления
Since:: 1.4

removePopupMenuListener

public void removePopupMenuListener(PopupMenuListener l)

Удаляет слушателя PopupMenuListener.

Parameters:

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

Since:

1.4

See Also:

getPopupMenuListeners

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

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

Returns:: все добавленные слушатели PopupMenuListener или пустой массив, если слушатели не добавлены
Since:: 1.4

firePopupMenuWillBecomeVisible

public void firePopupMenuWillBecomeVisible()

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

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

Since:

1.4

See Also:

firePopupMenuWillBecomeInvisible

public void firePopupMenuWillBecomeInvisible()

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

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

Since:

1.4

See Also:

firePopupMenuCanceled

public void firePopupMenuCanceled()

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

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

Since:

1.4

See Also:

УстановитьКомандуДействия

public void setActionCommand(String aCommand)

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

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

ПолучитьКомандуДействия

public String getActionCommand()

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

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

УстановитьДействие

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

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

Установка Action приводит к немедленному изменению всех свойств, описанных в Компоненты Swing, поддерживающие Action. Впоследствии свойства combobox автоматически обновляются по мере изменения свойств Action.

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

Параметры:

a - Action для JComboBox, или null.

С:

1.3

См. также:

ПолучитьДействие

public Action getAction()

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

Возвращает:

Action для этого источника ActionEvent; или null

С:

1.3

См. также:

НастроитьСвойстваИзДействия

protected void configurePropertiesFromAction(Action a)

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

Параметры:

a - Action, из которого получать свойства, или null

С:

1.3

См. также:

СоздатьСлушателяСвойствДействия

protected PropertyChangeListener createActionPropertyChangeListener(Action a)

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

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

Параметры:

a - действие combobox

Возвращает:

слушатель PropertyChangeListener

С:

1.3

См. также:

СвойствоДействияИзменилось

protected void actionPropertyChanged(Action action, String propertyName)

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

Список свойств, которые устанавливает этот метод, см. в таблице Компоненты Swing, поддерживающие Action.

Параметры:

action - Action, связанное с этим combobox

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

С:

1.6

См. также:

СгенерироватьИзменениеСостоянияЭлемента

protected void fireItemStateChanged(ItemEvent e)

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

Параметры:

e - событие, вызывающее интерес

См. также:

СгенерироватьСобытиеДействия

protected void fireActionEvent()

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

См. также:

ИзбранныйЭлементИзменился

protected void selectedItemChanged()

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

ПолучитьВыбранныеОбъекты

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

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

Установлено:: getSelectedObjects в интерфейсе ItemSelectable
Возвращает:: массив Objects, содержащий один элемент — выбранный элемент

ВыполнитьДействие

public void actionPerformed(ActionEvent e)

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

Установлено:: actionPerformed в интерфейсе ActionListener
Параметры:: e - событие для обработки

СодержаниеИзменилось

public void contentsChanged(ListDataEvent e)

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

Установлено:: contentsChanged в интерфейсе ListDataListener
Параметры:: e - ListDataEvent, содержащий информацию о событии

ИнтервалДобавлен

public void intervalAdded(ListDataEvent e)

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

Установлено:: intervalAdded в интерфейсе ListDataListener
Параметры:: e - ListDataEvent, содержащий информацию о событии

ИнтервалУдален

public void intervalRemoved(ListDataEvent e)

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

Установлено:: intervalRemoved в интерфейсе ListDataListener
Параметры:: e - ListDataEvent, содержащий информацию о событии

ВыбратьССимволомКлавиши

public boolean selectWithKeyChar(char keyChar)

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

Параметры:: keyChar - символ, обычно это нажатая пользователем клавиша
Возвращает:: 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 - ComboBoxEditor, который отображает элемент списка в поле раскрывающегося списка и позволяет его редактировать; anItem - объект для отображения и редактирования в поле

processKeyEvent

public void processKeyEvent(KeyEvent e)

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

Overrides:

processKeyEvent in class JComponent

Parameters:

e - объект KeyEvent, содержащий нажатую клавишу

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:: текущий используемый KeySelectionManager

getItemCount

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

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

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

getItemAt

public E getItemAt(int index)

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

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

createDefaultKeySelectionManager

protected JComboBox.KeySelectionManager createDefaultKeySelectionManager()

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

Returns:

текущий используемый KeySelectionManager списком

See Also:

paramString

protected String paramString()

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

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

getAccessibleContext

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

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

Specified by:: getAccessibleContext in interface Accessible
Overrides:: getAccessibleContext in class Component
Returns:: AccessibleJComboBox, который служит AccessibleContext для этого JComboBox

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JComboBox.html