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

С тех пор:

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)`	Создает выпадающий список, содержащий элементы в указанном векторе.
`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

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

См. также:

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 - the ComboBoxModel that provides the displayed list of items

См. также:

JComboBox

public JComboBox(E[] items)

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

Параметры:

items - an array of objects to insert into the combo box

См. также:

JComboBox

public JComboBox(Vector<E> items)

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

Параметры:

items - an array of vectors to insert into the combo box

См. также:

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 - the ComboBoxUI L&F object

См. также:

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 - the ComboBoxModel that provides the displayed list of items

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, которое даёт подсказку о том, использовать ли лёгкий popup для отображения JComboBox или тяжёлый, такой как JWindow или JFrame. Решение о выборе лёгкого или тяжёлого popup остаётся за JComboBox. Лёгкие окна более эффективны, но лёгкие и тяжёлые компоненты плохо сочетаются в GUI. Если в вашем приложении смешаны лёгкие и тяжёлые компоненты, отключите лёгкие popups. Значение свойства lightweightPopupEnabled по умолчанию — true, если не указано иначе в теме оформления. Некоторые темы оформления всегда используют тяжёлые popups, независимо от значения этого свойства.

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

Параметры:: aFlag - if true, lightweight popups are desired

isLightWeightPopupEnabled

public boolean isLightWeightPopupEnabled()

Возвращает значение свойства lightweightPopupEnabled.

Возвращает:

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

См. также:

УстановитьРедактируемость

@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 указывает, что поле редактируемое

ЯвляетсяРедактируемым

public boolean isEditable()

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

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

УстановитьМаксимальноеКоличествоСтрок

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

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

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

ПолучитьМаксимальноеКоличествоСтрок

public int getMaximumRowCount()

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

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

УстановитьОтображатель

@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 - отображатель, который отображает выбранный элемент

См. также:

ПолучитьОтображатель

public ListCellRenderer<? super E> getRenderer()

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

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

УстановитьРедактор

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

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

Параметры:

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

См. также:

ПолучитьРедактор

public ComboBoxEditor getEditor()

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

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

ВыбратьЭлемент

@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 для очистки выбора

ПолучитьВыбранныйЭлемент

public Object getSelectedItem()

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

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

Возвращает:

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

См. также:

УстановитьИндексВыбора

@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 больше или равно размеру

ПолучитьИндексВыбора

public int getSelectedIndex()

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

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

ПолучитьПрототипЗначениеОтображения

public E getPrototypeDisplayValue()

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

Возвращает:

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

С момента:

1.4

См. также:

УстановитьПрототипЗначениеОтображения

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

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

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

Параметры:

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

С момента:

1.4

См. также:

ДобавитьЭлемент

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; } };
   }

Параметры:

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

См. также:

ВставитьЭлемент

public void insertItemAt(E item, int index)

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

Параметры:

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

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

См. также:

УдалитьЭлемент

public void removeItem(Object anObject)

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

Параметры:

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

См. также:

УдалитьЭлементПоИндексу

public void removeItemAt(int anIndex)

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

Параметры:

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

См. также:

УдалитьВсеЭлементы

public void removeAllItems()

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

showPopup

public void showPopup()

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

См. также:

hidePopup

public void hidePopup()

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

См. также:

setPopupVisible

public void setPopupVisible(boolean v)

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

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

isPopupVisible

public boolean isPopupVisible()

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

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

addItemListener

public void addItemListener(ItemListener aListener)

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

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

Унаследовано от:

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

Параметры:

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

См. также:

removeItemListener

public void removeItemListener(ItemListener aListener)

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

Унаследовано от:

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

Параметры:

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

См. также:

getItemListeners

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

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

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

addActionListener

public void addActionListener(ActionListener l)

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

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

Параметры:

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

См. также:

removeActionListener

public void removeActionListener(ActionListener l)

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

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

getActionListeners

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

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

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

addPopupMenuListener

public void addPopupMenuListener(PopupMenuListener l)

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

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

Параметры:: l - слушатель для добавления
С тех пор как:: 1.4

removePopupMenuListener

public void removePopupMenuListener(PopupMenuListener l)

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

Параметры:

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

С тех пор как:

1.4

См. также:

getPopupMenuListeners

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

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

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

firePopupMenuWillBecomeVisible

public void firePopupMenuWillBecomeVisible()

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

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

С тех пор как:

1.4

См. также:

firePopupMenuWillBecomeInvisible

public void firePopupMenuWillBecomeInvisible()

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

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

С тех пор как:

1.4

См. также:

firePopupMenuCanceled

public void firePopupMenuCanceled()

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

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

С тех пор как:

1.4

См. также:

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)

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

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

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

Параметры:

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

С тех пор как:

1.3

См. также:

getAction

public Action getAction()

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

Возвращает:

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

С тех пор как:

1.3

См. также:

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)

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

Parameters:

a - Action для получения свойств или null

Since:

1.3

See Also:

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)

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

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

Parameters:

a - действие выпадающего списка

Returns:

PropertyChangeListener

Since:

1.3

See Also:

actionPropertyChanged

protected void actionPropertyChanged(Action action, String propertyName)

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

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

Parameters:

action - Action связанное с этим выпадающим списком

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

Since:

1.6

See Also:

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)

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

Parameters:

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

See Also:

fireActionEvent

protected void fireActionEvent()

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

See Also:

selectedItemChanged

protected void selectedItemChanged()

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

getSelectedObjects

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

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

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

actionPerformed

public void actionPerformed(ActionEvent e)

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

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

contentsChanged

public void contentsChanged(ListDataEvent e)

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

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

intervalAdded

public void intervalAdded(ListDataEvent e)

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

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

intervalRemoved

public void intervalRemoved(ListDataEvent e)

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

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

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 в классе JComponent

Parameters:

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

See Also:

configureEditor

public void configureEditor(ComboBoxEditor anEditor, Object anItem)

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

Parameters:: anEditor - ComboBoxEditor, отображающий элемент списка в поле выпадающего списка и позволяющий его редактировать; anItem - объект для отображения и редактирования в поле

processKeyEvent

public void processKeyEvent(KeyEvent e)

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

Overrides:

processKeyEvent в классе 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:

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

См. также:

paramString

protected String paramString()

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

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

getAccessibleContext

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

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

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Returns:: AccessibleJComboBox, который служит AccessibleContext для этого JComboBox

© 1993, 2023, 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/21/docs/api/java.desktop/javax/swing/JComboBox.html