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

Использование
Выбор в ComboBox
Добавьте варианты через addItems(), отслеживайте currentIndexChanged и считывайте выбранную метку с помощью currentText(). Текст-подсказка отображается, когда ничего не выбрано и поле пусто (в режиме редактирования задавайте его на lineEdit()).
#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;
auto* comboBox = new ComboBox(this);
comboBox->addItems({"Blue", "Green", "Red", "Yellow"});
comboBox->setCurrentIndex(0);
connect(comboBox, qOverload<int>(&ComboBox::currentIndexChanged),
this, [=](int index) {
status->setText(comboBox->currentText());
});import fluentqt
combo_box = fluentqt.ComboBox()
combo_box.addItems(['Blue', 'Green', 'Red', 'Yellow'])
combo_box.setCurrentIndex(0)
combo_box.currentIndexChanged.connect(
lambda _index: status.setText(f"Selected: {combo_box.currentText()}")
)API
ОбъявлениеНет подходящих элементов API.
fluent::basicinput::ComboBox
Наследует QComboBox · FluentElement · QMLPlus
Поле со списком Fluent с настраиваемым выпадающим списком, опциональным полем ввода и завершающим слотом.
Конструкторы
Деструкторы
Методы
Typography::FontRole fontRole() constПресет Fluent Typography для текста.
void setFontRole(Typography::FontRole role)Применяет пресет Fluent Typography и сбрасывает явное переопределение шрифта, даже если пресет не изменился.
void setFont(const QFont& font)Задаёт шрифт для поля, редактора и выпадающего списка независимо от обновлений темы.
int contentPaddingH() constГоризонтальный внутренний отступ содержимого в пикселях.
void setContentPaddingH(int px)Горизонтальный внутренний отступ содержимого в пикселях.
int contentPaddingV() constВертикальный внутренний отступ содержимого в пикселях.
void setContentPaddingV(int px)Вертикальный внутренний отступ содержимого в пикселях.
QString chevronGlyph() constГлиф iconfont для элемента стрелки.
void setChevronGlyph(const QString& glyph)Глиф iconfont для элемента стрелки.
int chevronSize() constРазмер глифа шеврона в пикселях.
void setChevronSize(int size)Размер глифа шеврона в пикселях.
QPoint chevronOffset() constПиксельное смещение, применяемое при отрисовке шеврона.
void setChevronOffset(const QPoint& offset)Пиксельное смещение, применяемое при отрисовке шеврона.
int popupOffset() constСмещение всплывающего окна относительно якоря в пикселях.
void setPopupOffset(int offset)Смещение всплывающего окна относительно якоря в пикселях.
qreal pressProgress() constПрогресс анимации нажатия для визуального отклика шеврона.
void setPressProgress(qreal p)Прогресс анимации нажатия для визуального отклика шеврона.
void setEditable(bool editable)Включает или отключает режим редактирования с использованием Fluent LineEdit.
void setLineEdit(QLineEdit* edit)Заменяет редактор QComboBox и синхронизирует состояние компоновки Fluent.
void setTrailingText(const QString& text)Отображает обычный текстовый суффикс в редактируемом и нередактируемом режимах без изменения значений элементов.
bool setTrailingWidget(QWidget* widget, WidgetOwnership ownership)Размещает завершающий виджет рядом с текстом или редактором, заменяя суффиксный текст. Передайте WidgetOwnership для указания порядка очистки; перед заменой вызовите takeTrailingWidget().
QWidget* takeTrailingWidget()Извлекает и возвращает завершающий виджет для управления или удаления вызывающим кодом.
void releaseTrailingWidget()Удаляет завершающий виджет и выполняет очистку согласно его режиму WidgetOwnership.
void setModel(QAbstractItemModel* model) FLUENT_QT6_ONLY_OVERRIDEЗадаёт модель элементов (управляется вызывающим кодом; не удаляется этим элементом управления).
Свойства
Typography::FontRole fontRoleПресет Fluent Typography для текста.
ЧтениеfontRole()ЗаписьsetFontRole()УведомлениеfontRoleChanged()int contentPaddingHГоризонтальный внутренний отступ содержимого в пикселях.
ЧтениеcontentPaddingH()ЗаписьsetContentPaddingH()УведомлениеlayoutChanged()int contentPaddingVВертикальный внутренний отступ содержимого в пикселях.
ЧтениеcontentPaddingV()ЗаписьsetContentPaddingV()УведомлениеlayoutChanged()QString chevronGlyphГлиф iconfont для элемента стрелки.
ЧтениеchevronGlyph()ЗаписьsetChevronGlyph()УведомлениеchevronChanged()int chevronSizeРазмер глифа шеврона в пикселях.
ЧтениеchevronSize()ЗаписьsetChevronSize()УведомлениеchevronChanged()QPoint chevronOffsetПиксельное смещение, применяемое при отрисовке шеврона.
ЧтениеchevronOffset()ЗаписьsetChevronOffset()УведомлениеchevronChanged()int popupOffsetСмещение всплывающего окна относительно якоря в пикселях.
ЧтениеpopupOffset()ЗаписьsetPopupOffset()УведомлениеlayoutChanged()qreal pressProgressПрогресс анимации нажатия для визуального отклика шеврона.
ЧтениеpressProgress()ЗаписьsetPressProgress()QString trailingText- Чтение
trailingText()ЗаписьsetTrailingText()УведомлениеtrailingTextChanged() QWidget* trailingWidget- Чтение
trailingWidget()УведомлениеtrailingWidgetChanged() fluent::WidgetOwnership trailingWidgetOwnership- Чтение
trailingWidgetOwnership()УведомлениеtrailingWidgetOwnershipChanged()
Сигналы
void fontRoleChanged()Пресет Fluent Typography для текста.
void layoutChanged()Горизонтальный внутренний отступ содержимого в пикселях.
void chevronChanged()Глиф iconfont для элемента стрелки.
Дополнения PySide6
Защищённые члены
Методы
Унаследовано от 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: QComboBox
fluent::basicinput::ComboBoxItemDelegate
Наследует QStyledItemDelegate
Делегат элементов, отрисовывающий строки всплывающего списка ComboBox с метриками и цветами темы Fluent.