ComboBox
Элемент выбора значения из выпадающего списка с возможностью прокрутки опций.
Обзор
ComboBox позволяет выбрать один элемент из списка предложенных вариантов. При открытии отображается всплывающее меню с поддержкой прокрутки и подсветкой опций.
Выбор разрешения
ComboBox resolution = new ComboBox()
.options("1920x1080", "2560x1440", "3840x2160")
.selectedIndex(0);
resolution.onSelectionChanged(e -> applyResolution(resolution.selectedItem()));
API
ComboBox::addItem(String)
Добавить вариант
Добавляет один вариант в список выбора.
| Параметр | Тип | Описание |
|---|---|---|
item |
String |
— |
Возвращает ComboBox.
ComboBox::close()
Закрыть список
Закрывает всплывающее меню вариантов.
Возвращает ComboBox.
ComboBox::itemCount()
Количество вариантов
Возвращает общее количество доступных элементов выбора.
Возвращает int.
ComboBox::items()
Получить список вариантов
Возвращает список текстовых вариантов выбора.
Возвращает List.
ComboBox::items(List)
Задать варианты выбора
Устанавливает варианты выбора выпадающего списка.
| Параметр | Тип | Описание |
|---|---|---|
items |
List |
— |
Возвращает ComboBox.
ComboBox::open()
Открыть список
Раскрывает всплывающее меню вариантов.
Возвращает ComboBox.
ComboBox::opened()
Состояние открытия
Возвращает true, если выпадающий список открыт.
Возвращает boolean.
ComboBox::optionHoverBackground(ColorView)
Фон при наведении
Задает цвет подсветки пункта меню при наведении курсора.
| Параметр | Тип | Описание |
|---|---|---|
color |
ColorView |
— |
Возвращает ComboBox.
ComboBox::removeItem(int)
Удалить вариант
Удаляет вариант выбора по указанному индексу.
| Параметр | Тип | Описание |
|---|---|---|
index |
int |
— |
Возвращает ComboBox.
ComboBox::selectedIndex()
Индекс выбранного элемента
Возвращает индекс выбранного элемента или -1, если ничего не выбрано.
Возвращает int.
ComboBox::selectedIndex(int)
Выбрать индекс
Выбирает вариант по индексу и обновляет заголовок.
| Параметр | Тип | Описание |
|---|---|---|
index |
int |
индекс варианта |
Возвращает ComboBox.
ComboBox::selectedItem()
Выбранная строка
Возвращает текст выбранного варианта или пустую строку.
Возвращает String.
ComboBox::silentSelectedIndex(int)
Задать индекс без событий
Устанавливает индекс выбранного элемента без генерации событий изменения.
| Параметр | Тип | Описание |
|---|---|---|
index |
int |
— |
Возвращает ComboBox.
ComboBox::toggle()
Переключить список
Инвертирует открытое/закрытое состояние списка.
Возвращает ComboBox.