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

Использование
Выбор из иерархии
Привяжите иерархические данные через setModel(); ключи элементов берутся из Qt::UserRole и могут быть предварительно выбраны через setSelectedKeys(). Невыбираемые узлы групп раскрываются без выбора.
#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;
auto* select = new fluent::basicinput::TreeSelect(this);
select->setAccessibleName("Team");
select->setPlaceholderText("Choose a team");
auto* model = new QStandardItemModel(select);
auto* product = new QStandardItem("Product");
product->setSelectable(false);
auto* client = new QStandardItem("Client");
client->setData("client", Qt::UserRole);
auto* platform = new QStandardItem("Platform");
platform->setData("platform", Qt::UserRole);
product->appendRow(client);
product->appendRow(platform);
model->appendRow(product);
select->setModel(model);
select->setSelectedKeys({"client"});
select->setMaximumWidth(360);import fluentqt
from PySide6.QtCore import Qt
from PySide6.QtGui import QStandardItem, QStandardItemModel
select = fluentqt.TreeSelect()
select.setAccessibleName("Team")
select.setObjectName("basicTreeSelect")
select.setPlaceholderText("Choose a team")
model = QStandardItemModel(select)
product = QStandardItem("Product")
product.setSelectable(False)
client = QStandardItem("Client")
client.setData("client", Qt.UserRole)
platform = QStandardItem("Platform")
platform.setData("platform", Qt.UserRole)
product.appendRow(client)
product.appendRow(platform)
model.appendRow(product)
select.setModel(model)
select.setSelectedKeys(["client"])
select.setMaximumWidth(360)API
ОбъявлениеНет подходящих элементов API.
fluent::basicinput::TreeSelect
Наследует QWidget · FluentElement · QMLPlus
Выпадающий список с поиском и одиночным или множественным выбором на основе древовидной модели. Берёт метки из DisplayRole столбца 0 и уникальные строковые ключи из keyRole (по умолчанию UserRole); элементы выбираются независимо.
Конструкторы
Деструкторы
Перечисления
enum class SelectionModeSingleMultiple
Методы
void setModel(QAbstractItemModel* model)Задаёт исходную древовидную модель (управляется вызывающим кодом; не удаляется этим элементом управления).
QVariantList selectedItems() constСнимки выбранных значений со строками key, text и полного path.
void setSelectedKeys(const QStringList& keys)Выбирает известные доступные для выбора ключи; в режиме Single сохраняется только первый корректный ключ.
void setSearchText(const QString& text)Немедленно применяет запрос; при интерактивном вводе в больших деревьях фильтрация выполняется с задержкой (debounce).
QString emptyText() constСообщение при отсутствии совпадений поиска; пустая строка скрывает сообщение.
void setEmptyText(const QString& text)Сообщение при отсутствии совпадений поиска; пустая строка скрывает сообщение.
Свойства
QAbstractItemModel* model- Чтение
model()ЗаписьsetModel()УведомлениеmodelChanged() int keyRole- Чтение
keyRole()ЗаписьsetKeyRole()УведомлениеkeyRoleChanged() SelectionMode selectionMode- Чтение
selectionMode()ЗаписьsetSelectionMode()УведомлениеselectionModeChanged() QStringList selectedKeys- Чтение
selectedKeys()ЗаписьsetSelectedKeys()УведомлениеselectionChanged() QVariantList selectedItemsСнимки выбранных значений со строками key, text и полного path.
ЧтениеselectedItems()УведомлениеselectionChanged()int selectedCount- Чтение
selectedCount()УведомлениеselectionChanged() QString searchText- Чтение
searchText()ЗаписьsetSearchText()УведомлениеsearchTextChanged() QString placeholderText- Чтение
placeholderText()ЗаписьsetPlaceholderText()УведомлениеplaceholderTextChanged() QString emptyTextСообщение при отсутствии совпадений поиска; пустая строка скрывает сообщение.
ЧтениеemptyText()ЗаписьsetEmptyText()УведомлениеemptyTextChanged()bool readOnly- Чтение
isReadOnly()ЗаписьsetReadOnly()УведомлениеreadOnlyChanged() bool isOpen- Чтение
isOpen()ЗаписьsetIsOpen()УведомлениеisOpenChanged()
Сигналы
void selectionChanged()Снимки выбранных значений со строками key, text и полного path.
void emptyTextChanged()Сообщение при отсутствии совпадений поиска; пустая строка скрывает сообщение.
Защищённые члены
Методы
Унаследовано от 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