Базовый ввод
MultiSelectComboBox Список с множественным выбором
Раскрывающийся список с поиском для выбора нескольких элементов.
Пример
Не удалось загрузить предпросмотр свойств. Выберите предпросмотр свойств ещё раз для повтора.

Использование
Выбор нескольких строк модели
Передайте варианты через setModel() и задайте начальные отметки через setSelectedRows(). Выпадающий список остаётся открытым при переключении элементов; считывайте selectedIndexes() по сигналу selectionChanged. maximumVisibleItems ограничивает число видимых строк списка с прокруткой остальных.
#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;
auto* model = new QStringListModel(
{"Design", "Engineering", "Research", "Support"}, this);
auto* box = new MultiSelectComboBox(this);
box->setModel(model);
box->setPlaceholderText("Choose teams");
box->setAccessibleName("Teams");
box->setSelectedRows({0, 2});
box->setFixedWidth(280);
auto* status = new Label(this);
status->setFixedWidth(280);
status->setWordWrap(true);
auto updateStatus = [box, status] {
QStringList labels;
for (const QModelIndex& index : box->selectedIndexes())
labels << index.data().toString();
status->setText(QStringLiteral("Selected: %1")
.arg(labels.join(", ")));
};
connect(box, &MultiSelectComboBox::selectionChanged,
this, [=] { updateStatus(); });
updateStatus();import fluentqt
from PySide6.QtCore import QStringListModel
model = QStringListModel(
['Design', 'Engineering', 'Research', 'Support'],
root
)
box = fluentqt.MultiSelectComboBox()
box.setModel(model)
box.setPlaceholderText('Choose teams')
box.setAccessibleName('Teams')
box.setSelectedRows([0, 2])
box.setFixedWidth(280)
status = fluentqt.Label()
status.setFixedWidth(280)
status.setWordWrap(True)
def update_status(*_args):
labels = [index.data() for index in box.selectedIndexes()]
status.setText(f"Selected: {', '.join(labels)}")
box.selectionChanged.connect(update_status)API
ОбъявлениеНет подходящих элементов API.
fluent::basicinput::MultiSelectComboBox
Наследует QWidget · FluentElement · QMLPlus
Выпадающий список Fluent на основе модели для множественного выбора строк. По умолчанию использует встроенную QItemSelectionModel; внешние модели данных и выбора остаются под управлением вызывающей стороны.
Конструкторы
Деструкторы
Методы
QAbstractItemModel* model() constИсходная модель, предоставляющая варианты выпадающего списка.
void setModel(QAbstractItemModel* model)Задаёт исходную модель (управляется вызывающим кодом; не удаляется этим элементом управления).
QItemSelectionModel* selectionModel() constМодель выделения, хранящая отмеченные строки (по умолчанию используется внутренняя).
void setSelectionModel(QItemSelectionModel* selectionModel)Задаёт пользовательскую модель выделения (управляется вызывающим кодом; не удаляется этим элементом управления).
int modelColumn() constСтолбец исходной модели, используемый для меток и фильтрации.
void setModelColumn(int column)Столбец исходной модели, используемый для меток и фильтрации.
QModelIndex rootModelIndex() constКорень исходной модели, прямые потомки которого образуют список вариантов.
void setRootModelIndex(const QModelIndex& index)Корень исходной модели, прямые потомки которого образуют список вариантов.
QString placeholderText() constТекст, отображаемый, когда не выбрана ни одна доступная строка.
void setPlaceholderText(const QString& text)Текст, отображаемый, когда не выбрана ни одна доступная строка.
bool isSearchEnabled() constОпределяет, отображается ли во всплывающем списке поле локального поиска подстроки.
void setSearchEnabled(bool enabled)Определяет, отображается ли во всплывающем списке поле локального поиска подстроки.
QString searchPlaceholderText() constТекст-заполнитель, используемый во всплывающем поле поиска.
void setSearchPlaceholderText(const QString& text)Текст-заполнитель, используемый во всплывающем поле поиска.
bool isSelectAllVisible() constПоказывает ли список трёхсостояний флажок «Выбрать все».
void setSelectAllVisible(bool visible)Показывает ли список трёхсостояний флажок «Выбрать все».
int maximumVisibleItems() constМаксимальное число строк параметров, видимых до появления прокрутки.
void setMaximumVisibleItems(int count)Максимальное число строк параметров, видимых до появления прокрутки.
bool isOpen() constЛогическое состояние открытия всплывающего окна.
int selectedCount() constКоличество выбранных доступных для выбора строк под rootModelIndex.
void setSelectedRows(const QList<int>& rows)Заменяет выбранные строки под активным корнем.
void clearSelection()Снимает выделение строк под активным корневым индексом.
void selectAll()Выбирает все доступные и допускающие выбор исходные строки под корнем.
void open()Открывает привязанный выпадающий список.
void close()Закрывает выпадающий список, сохраняя текущий выбор.
void setIsOpen(bool open)Логическое состояние открытия всплывающего окна.
Свойства
QAbstractItemModel* modelИсходная модель, предоставляющая варианты выпадающего списка.
Чтениеmodel()ЗаписьsetModel()УведомлениеmodelChanged()QItemSelectionModel* selectionModelМодель выделения, хранящая отмеченные строки (по умолчанию используется внутренняя).
ЧтениеselectionModel()ЗаписьsetSelectionModel()УведомлениеselectionModelChanged()int modelColumnСтолбец исходной модели, используемый для меток и фильтрации.
ЧтениеmodelColumn()ЗаписьsetModelColumn()УведомлениеmodelColumnChanged()QModelIndex rootModelIndexКорень исходной модели, прямые потомки которого образуют список вариантов.
ЧтениеrootModelIndex()ЗаписьsetRootModelIndex()УведомлениеrootModelIndexChanged()QString placeholderTextТекст, отображаемый, когда не выбрана ни одна доступная строка.
ЧтениеplaceholderText()ЗаписьsetPlaceholderText()УведомлениеplaceholderTextChanged()bool searchEnabledОпределяет, отображается ли во всплывающем списке поле локального поиска подстроки.
ЧтениеisSearchEnabled()ЗаписьsetSearchEnabled()УведомлениеsearchEnabledChanged()QString searchPlaceholderTextТекст-заполнитель, используемый во всплывающем поле поиска.
ЧтениеsearchPlaceholderText()ЗаписьsetSearchPlaceholderText()УведомлениеsearchPlaceholderTextChanged()bool selectAllVisibleПоказывает ли список трёхсостояний флажок «Выбрать все».
ЧтениеisSelectAllVisible()ЗаписьsetSelectAllVisible()УведомлениеselectAllVisibleChanged()int maximumVisibleItemsМаксимальное число строк параметров, видимых до появления прокрутки.
ЧтениеmaximumVisibleItems()ЗаписьsetMaximumVisibleItems()УведомлениеmaximumVisibleItemsChanged()bool isOpenЛогическое состояние открытия всплывающего окна.
ЧтениеisOpen()ЗаписьsetIsOpen()УведомлениеisOpenChanged()int selectedCountКоличество выбранных доступных для выбора строк под rootModelIndex.
ЧтениеselectedCount()УведомлениеselectedCountChanged()
Сигналы
void modelChanged(QAbstractItemModel* model)Исходная модель, предоставляющая варианты выпадающего списка.
void selectionModelChanged(QItemSelectionModel* selectionModel)Модель выделения, хранящая отмеченные строки (по умолчанию используется внутренняя).
void modelColumnChanged(int column)Столбец исходной модели, используемый для меток и фильтрации.
void rootModelIndexChanged(const QModelIndex& index)Корень исходной модели, прямые потомки которого образуют список вариантов.
void selectedCountChanged(int count)Количество выбранных доступных для выбора строк под rootModelIndex.
void placeholderTextChanged(const QString& text)Текст, отображаемый, когда не выбрана ни одна доступная строка.
void searchEnabledChanged(bool enabled)Определяет, отображается ли во всплывающем списке поле локального поиска подстроки.
void searchPlaceholderTextChanged(const QString& text)Текст-заполнитель, используемый во всплывающем поле поиска.
void selectAllVisibleChanged(bool visible)Показывает ли список трёхсостояний флажок «Выбрать все».
void maximumVisibleItemsChanged(int count)Максимальное число строк параметров, видимых до появления прокрутки.
void isOpenChanged(bool open)Логическое состояние открытия всплывающего окна.
Защищённые члены
Методы
Унаследовано от fluent::FluentElement
Перечисления
enum ThemeГлобальная визуальная тема, используемая при разрешении дизайн-токенов.
Light = 0Dark = 1HighContrast = 2
Методы
static void setTheme(Theme theme)Обновляет глобальную тему и уведомляет активные экземпляры FluentElement.
static void setThemeDeferred(Theme theme)Планирует пакетное обновление темы с приоритетом видимых элементов без блокировки текущего взаимодействия.
static Theme currentTheme()Возвращает текущую активную глобальную тему.
static bool themeUsesDarkAppearance(Theme theme)Возвращает, использует ли тема токены тёмного оформления и материалов.
static void refreshTheme()Повторно рассылает текущую тему для перерисовки после изменения дизайн-токенов.
static int themeGeneration()Монотонный счётчик, увеличиваемый при каждом изменении темы для проверки актуальности.
Theme effectiveTheme() constОпределяет тему, используемую этим элементом, с учётом унаследованного переопределения QWidget.
bool effectiveThemeUsesDarkAppearance() constВозвращает, использует ли действующая тема этого элемента тёмную основу оформления.
bool setThemeOverrides(const QJsonObject& overrides)Заменяет разреженные переопределения токенов цвета, скругления и шрифта этого элемента.
QJsonObject themeOverrides() constВозвращает заданные переопределения этого элемента.
void clearThemeOverrides()Восстанавливает для всех полей токенов значения глобальной темы по умолчанию.
const Colors& themeColorsRef() constДоступ без копирования к активному набору цветов для горячих путей отрисовки.
Material::AcrylicToken themeAcrylic() constТокены материалов, возвышения и адаптивной компоновки.
QColor themeBackdrop(bool active) constЦвет фона рамки окна для заданного состояния активации.
virtual void onThemeUpdated()Вызывается после изменения глобальной темы.
Типы и псевдонимы
struct ColorsСнимки дизайн-токенов, возвращаемые компонентам.
Унаследовано от fluent::QMLPlus
Методы
AnchorLayout::Anchors* anchors()Возвращает изменяемые привязки для хоста QWidget.
void setState(const QString& name)Применяет зарегистрированное состояние по имени или восстанавливает состояние по умолчанию, если @p name пусто. Неизвестные имена игнорируются, а при выходе из состояния возобновляются прежние привязки.
void addState(const QMLState& state)Регистрирует или заменяет именованное определение состояния; замена активного состояния применяется немедленно.
void evaluateStates()Повторно вычисляет условия состояний в порядке регистрации и активирует первое совпадение или состояние по умолчанию, если совпадений нет. Также выполняется автоматически при уведомлениях свойств-зависимостей; производные состояния с extend наследуют изменения предков, если нет циклов или пропусков.
QMLPlusRuntime* runtime()Возвращает лениво создаваемый наблюдатель состояния, принадлежащий этому хосту.
void setAnchors(const AnchorLayout::Anchors& anchors)Заменяет все привязки хоста и инвалидирует родительскую компоновку.
void resetAnchors()Очищает все привязки хоста и делает родительский макет недействительным.
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)Связывает @p sourceProp объекта @p source со свойством @p targetProp этого хоста QWidget через PropertyBinder::bind().
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Устанавливает управляемую прямую привязку на этом хосте QWidget.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Устанавливает C++-выражение с явными зависимостями на этом хосте QWidget.
void addTransition(const StateTransition& transition)Регистрирует переход состояния в порядке приоритета.
void setBehavior(const char* propertyName, const PropertyAnimation& animation)Задаёт анимацию по умолчанию при записи @p propertyName через writeProperty() или привязку. Явные правила StateTransition имеют приоритет; прямые вызовы C++ сеттеров не анимируются.
void clearBehavior(const char* propertyName)Удаляет анимацию по умолчанию для последующих управляемых записей.
bool writeProperty(const char* propertyName, const QVariant& value)Записывает свойство хоста через Behavior без удаления его привязки.
Документация базового класса Qt: QWidget