Fluent-Qt

Базовый ввод

MultiSelectComboBox Список с множественным выбором

Раскрывающийся список с поиском для выбора нескольких элементов.

Пример

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

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 = 0
  • Dark = 1
  • HighContrast = 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 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