Класс JComboBox<E>

Type Parameters:
E - тип элементов этого раскрывающегося списка
All Implemented Interfaces:
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.

Since:
1.2
See Also:
ComboBoxModel, DefaultComboBoxModel, Serialized Form

Вложенные классы

Модификатор и тип Класс Описание
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)

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

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

Методы, объявленные в классе 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, 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, hide, 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 предоставляется, созданный таким конструктором выпадающий список не создаёт модель выпадающего списка по умолчанию, что может повлиять на поведение методов insert, remove и add.

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

JComboBox

public JComboBox(E[] items)

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

Параметры:
items - массив объектов для вставки в выпадающий список
См. также:
DefaultComboBoxModel

JComboBox

public JComboBox(Vector<E> items)

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

Параметры:
items - массив векторов для вставки в выпадающий список
См. также:
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"
См. также:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

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

Параметры:
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 отображающий выбранный элемент
См. также:
setEditor(javax.swing.ComboBoxEditor)

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 отображающий выбранный элемент
См. также:
setRenderer(javax.swing.ListCellRenderer<? super E>)

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 или конструкторов данных.

Возвращает:
текущий выбранный объект
См. также:
setSelectedItem(java.lang.Object)

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(E)

setPrototypeDisplayValue

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

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

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

Параметры:
prototypeDisplayValue - значение отображения прототипа
С момента:
1.4
См. также:
getPrototypeDisplayValue()

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; } };
   }
Параметры:
item - добавляемый элемент в список
См. также:
MutableComboBoxModel

insertItemAt

public void insertItemAt(E item,
                         int index)

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

Параметры:
item - элемент для добавления в список
index - целое число, определяющее позицию для добавления элемента
См. также:
MutableComboBoxModel

removeItem

public void removeItem(Object anObject)

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

Параметры:
anObject - объект для удаления из списка элементов
См. также:
MutableComboBoxModel

removeItemAt

public void removeItemAt(int anIndex)

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

Параметры:
anIndex - целое число, определяющее индекс удаляемого элемента, где 0 обозначает первый элемент в списке
См. также:
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()

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

Возвращает:
все добавленные слушатели ItemListener или пустой массив, если слушатели не добавлены
С момента:
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()

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

Возвращает:
все добавленные слушатели событий ActionListener или пустой массив, если слушатели не добавлены
С момента:
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()

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

Возвращает:
все добавленные слушатели событий всплывающего меню PopupMenuListener или пустой массив, если слушатели не добавлены
С момента:
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)

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

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

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

Параметры:
a - Action для JComboBox, или null.
С момента:
1.3
См. также:
Action, getAction(), configurePropertiesFromAction(javax.swing.Action), createActionPropertyChangeListener(javax.swing.Action), actionPropertyChanged(javax.swing.Action, java.lang.String)

getAction

public Action getAction()

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

Возвращает:
значение Action для этого ActionEvent источника; или null
С тех пор:
1.3
См. также:
Action, setAction(javax.swing.Action)

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)

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

Параметры:
a - Action для получения свойств, или null
С тех пор:
1.3
См. также:
Action, setAction(javax.swing.Action)

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)

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

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

Параметры:
a - действие выпадающего списка
Возвращает:
PropertyChangeListener
С тех пор:
1.3
См. также:
Action, setAction(javax.swing.Action)

actionPropertyChanged

protected void actionPropertyChanged(Action action,
                                     String propertyName)

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

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

Параметры:
action - Action связанный с этим выпадающим списком
propertyName - имя свойства, которое изменилось
С тех пор:
1.6
См. также:
Action, configurePropertiesFromAction(javax.swing.Action)

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)

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

Параметры:
e - событие, представляющее интерес
См. также:
EventListenerList

fireActionEvent

protected void fireActionEvent()

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

См. также:
EventListenerList

selectedItemChanged

protected void selectedItemChanged()

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

getSelectedObjects

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

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

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

actionPerformed

public void actionPerformed(ActionEvent e)

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

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

contentsChanged

public void contentsChanged(ListDataEvent e)

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

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

intervalAdded

public void intervalAdded(ListDataEvent e)

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

Определено в:
intervalAdded в интерфейсе ListDataListener
Параметры:
e - ListDataEvent encapsulating the event information

intervalRemoved

public void intervalRemoved(ListDataEvent e)

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

Определено в:
intervalRemoved в интерфейсе ListDataListener
Параметры:
e - ListDataEvent encapsulating the event information

selectWithKeyChar

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)

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

Переопределяет:
setEnabled в классе JComponent
Параметры:
b - значение boolean, где true включает компонент, а false отключает его
См. также:
Component.isEnabled(), Component.isLightweight()

configureEditor

public void configureEditor(ComboBoxEditor anEditor,
                            Object anItem)

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

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

processKeyEvent

public void processKeyEvent(KeyEvent e)

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

Переопределяет:
processKeyEvent в классе JComponent
Параметры:
e - KeyEvent событие, содержащее нажатую клавишу
См. также:
KeyEvent, KeyListener, KeyboardFocusManager, DefaultKeyboardFocusManager, Component.processEvent(java.awt.AWTEvent), Component.dispatchEvent(java.awt.AWTEvent), Component.addKeyListener(java.awt.event.KeyListener), Component.enableEvents(long), Component.isShowing()

setKeySelectionManager

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

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

Параметры:
aManager - менеджер выбора клавиш

getKeySelectionManager

public JComboBox.KeySelectionManager getKeySelectionManager()

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

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

getItemCount

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

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

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

getItemAt

public E getItemAt(int index)

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

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

createDefaultKeySelectionManager

protected JComboBox.KeySelectionManager createDefaultKeySelectionManager()

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

Возвращает:
KeySelectionManager, в настоящее время используемый списком
См. также:
setKeySelectionManager(javax.swing.JComboBox.KeySelectionManager)

paramString

protected String paramString()

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

Переопределяет:
paramString в классе JComponent
Возвращает:
строковое представление этого JComboBox

getAccessibleContext

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

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

Определено в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
AccessibleJComboBox, являющийся AccessibleContext этого JComboBox

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

Spec-Zone .ru
спецификации, руководства, описания, API