Класс JComboBox<E>

protected ComboBoxModel<E> dataModel

См. также:

• getModel()
• setModel(ComboBoxModel)

protected ListCellRenderer<? super E> renderer

См. также:

• getRenderer()
• setRenderer(ListCellRenderer)

protected ComboBoxEditor editor

См. также:

• getEditor()
• setEditor(ComboBoxEditor)

protected int maximumRowCount

См. также:

• getMaximumRowCount()
• setMaximumRowCount(int)

protected boolean isEditable

См. также:

• isEditable()
• setEditable(boolean)

protected JComboBox.KeySelectionManager keySelectionManager

См. также:

• setKeySelectionManager(JComboBox.KeySelectionManager)
• getKeySelectionManager()

protected String actionCommand

См. также:

• setActionCommand(String)
• getActionCommand()

protected boolean lightWeightPopupEnabled

См. также:

• setLightWeightPopupEnabled(boolean)
• isLightWeightPopupEnabled()

protected Object selectedItemReminder

public JComboBox(ComboBoxModel<E> aModel)

Параметры:

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

См. также:

• DefaultComboBoxModel

public JComboBox(E[] items)

Параметры:

items — массив объектов для добавления в комбинированный список

См. также:

• DefaultComboBoxModel

public JComboBox(Vector<E> items)

Параметры:

items — массив векторов для добавления в комбинированный список

См. также:

• DefaultComboBoxModel

public JComboBox()

См. также:

• DefaultComboBoxModel

protected void installAncestorListener()

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

Параметры:

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

См. также:

• UIDefaults.getUI(JComponent)

public void updateUI()

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

updateUI в классе JComponent

См. также:

• JComponent.updateUI()

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

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

getUIClassID в классе JComponent

Возвращает:

строку "ComboBoxUI"

См. также:

• JComponent.getUIClassID()
• UIDefaults.getUI(JComponent)

public ComboBoxUI getUI()

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

getUI в классе JComponent

Возвращает:

объект ComboBoxUI, который отображает этот компонент

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

Параметры:

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

public ComboBoxModel<E> getModel()

Возвращает:

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

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

Параметры:

aFlag — если true, предпочтительно использовать лёгкие всплывающие окна

public boolean isLightWeightPopupEnabled()

Возвращает:

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

См. также:

• setLightWeightPopupEnabled(boolean)

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

Параметры:

aFlag — логическое значение; true указывает, что поле доступно для редактирования

public boolean isEditable()

Возвращает:

true, если JComboBox доступен для редактирования; иначе false

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

Параметры:

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)

Параметры:

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

См. также:

• setEditor(ComboBoxEditor)

public ListCellRenderer<? super E> getRenderer()

Возвращает:

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

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

Параметры:

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

См. также:

• setRenderer(ListCellRenderer)

public ComboBoxEditor getEditor()

Возвращает:

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

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

Параметры:

anObject — объект списка, который нужно выбрать; используйте null, чтобы снять выделение

public Object getSelectedItem()

Возвращает:

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

См. также:

• setSelectedItem(Object)

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

Параметры:

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

Вызывает исключение:

IllegalArgumentException — если anIndex < -1 или anIndex больше либо равно размеру

public int getSelectedIndex()

Возвращает:

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

public E getPrototypeDisplayValue()

Возвращает:

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

Начиная с:

1.4

См. также:

• setPrototypeDisplayValue(E)

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

Параметры:

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

Начиная с:

1.4

См. также:

• getPrototypeDisplayValue()

public void addItem(E item)

  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

public void insertItemAt(E item, int index)

Параметры:

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

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

См. также:

• MutableComboBoxModel

public void removeItem(Object anObject)

Параметры:

anObject — объект для удаления из списка

См. также:

• MutableComboBoxModel

public void removeItemAt(int anIndex)

Параметры:

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

См. также:

• MutableComboBoxModel

public void removeAllItems()

public void showPopup()

См. также:

• setPopupVisible(boolean)

public void hidePopup()

См. также:

• setPopupVisible(boolean)

public void setPopupVisible(boolean v)

Параметры:

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

public boolean isPopupVisible()

Возвращает:

true, если всплывающее окно отображается; иначе возвращает false

public void addItemListener(ItemListener aListener)

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

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

Параметры:

aListener — ItemListener, который нужно уведомлять

См. также:

• setSelectedItem(Object)

public void removeItemListener(ItemListener aListener)

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

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

Параметры:

aListener — ItemListener для удаления

См. также:

• ItemEvent

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

Возвращает:

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

Начиная с:

1.4

public void addActionListener(ActionListener l)

Параметры:

l — ActionListener, который нужно уведомлять

См. также:

• setSelectedItem(Object)

public void removeActionListener(ActionListener l)

Параметры:

l — ActionListener для удаления

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

Возвращает:

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

Начиная с:

1.4

public void addPopupMenuListener(PopupMenuListener l)

Параметры:

l — PopupMenuListener для добавления

Начиная с:

1.4

public void removePopupMenuListener(PopupMenuListener l)

Параметры:

l — PopupMenuListener для удаления

Начиная с:

1.4

См. также:

• addPopupMenuListener(PopupMenuListener)

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

Возвращает:

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

Начиная с:

1.4

public void firePopupMenuWillBecomeVisible()

Начиная с:

1.4

См. также:

• addPopupMenuListener(PopupMenuListener)

public void firePopupMenuWillBecomeInvisible()

Начиная с:

1.4

См. также:

• addPopupMenuListener(PopupMenuListener)

public void firePopupMenuCanceled()

Начиная с:

1.4

См. также:

• addPopupMenuListener(PopupMenuListener)

public void setActionCommand(String aCommand)

Параметры:

aCommand — строка, содержащая «команду», отправляемую слушателям действий; один и тот же слушатель может выполнять разные действия в зависимости от полученной команды

public String getActionCommand()

Возвращает:

строку, содержащую «команду», отправляемую слушателям действий.

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

Параметры:

a — Action для JComboBox или null.

Начиная с:

1.3

См. также:

• Action
• getAction()
• configurePropertiesFromAction(Action)
• createActionPropertyChangeListener(Action)
• actionPropertyChanged(Action, String)

public Action getAction()

Возвращает:

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

Начиная с:

1.3

См. также:

• Action
• setAction(Action)

protected void configurePropertiesFromAction(Action a)

Параметры:

a — Action, из которого извлекаются свойства, или null

Начиная с:

1.3

См. также:

• Action
• setAction(Action)

protected PropertyChangeListener createActionPropertyChangeListener(Action a)

Параметры:

a — действие комбинированного списка

Возвращает:

PropertyChangeListener

Начиная с:

1.3

См. также:

• Action
• setAction(Action)

protected void actionPropertyChanged(Action action, String propertyName)

Параметры:

action — Action, связанное с этим комбинированным списком

propertyName — имя изменившегося свойства

Начиная с:

1.6

См. также:

• Action
• configurePropertiesFromAction(Action)

protected void fireItemStateChanged(ItemEvent e)

Параметры:

e — интересующее событие

См. также:

• EventListenerList

protected void fireActionEvent()

См. также:

• EventListenerList

protected void selectedItemChanged()

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

Определен в:

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

Возвращает:

массив Objects с одним элементом — выбранным элементом

public void actionPerformed(ActionEvent e)

Определен в:

actionPerformed в интерфейсе ActionListener

Параметры:

e — обрабатываемое событие

public void contentsChanged(ListDataEvent e)

Определен в:

contentsChanged в интерфейсе ListDataListener

Параметры:

e — ListDataEvent, содержащий сведения о событии

public void intervalAdded(ListDataEvent e)

Определен в:

intervalAdded в интерфейсе ListDataListener

Параметры:

e — ListDataEvent, содержащий сведения о событии

public void intervalRemoved(ListDataEvent e)

Определен в:

intervalRemoved в интерфейсе ListDataListener

Параметры:

e — ListDataEvent, содержащий сведения о событии

public boolean selectWithKeyChar(char keyChar)

Параметры:

keyChar — символ, обычно соответствующий клавише, нажатой пользователем

Возвращает:

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

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

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

setEnabled в классе JComponent

Параметры:

b — логическое значение: true включает компонент, false отключает его

См. также:

• Component.isEnabled()
• Component.isLightweight()

public void configureEditor(ComboBoxEditor anEditor, Object anItem)

Параметры:

anEditor — ComboBoxEditor, отображающий элемент списка в поле комбинированного списка и позволяющий его редактировать

anItem — объект, отображаемый и редактируемый в поле

public void processKeyEvent(KeyEvent e)

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

processKeyEvent в классе JComponent

Параметры:

e — KeyEvent, содержащий сведения о нажатой клавише клавиатуры

См. также:

• KeyEvent
• KeyListener
• KeyboardFocusManager
• DefaultKeyboardFocusManager
• Component.processEvent(AWTEvent)
• Component.dispatchEvent(AWTEvent)
• Component.addKeyListener(KeyListener)
• Component.enableEvents(long)
• Component.isShowing()

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

Параметры:

aManager — диспетчер выбора по клавише

public JComboBox.KeySelectionManager getKeySelectionManager()

Возвращает:

используемый в данный момент KeySelectionManager

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

Возвращает:

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

public E getItemAt(int index)

Параметры:

index — целое число, задающее позицию в списке; первый элемент имеет индекс ноль

Возвращает:

элемент в указанной позиции списка или null, если индекс выходит за пределы диапазона

protected JComboBox.KeySelectionManager createDefaultKeySelectionManager()

Возвращает:

используемый в данный момент списком KeySelectionManager

См. также:

• setKeySelectionManager(JComboBox.KeySelectionManager)

protected String paramString()

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

paramString в классе JComponent

Возвращает:

строковое представление этого JComboBox

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

Определен в:

getAccessibleContext в интерфейсе Accessible

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

getAccessibleContext в классе Component

Возвращает:

AccessibleJComboBox, служащий AccessibleContext для этого JComboBox