Fluent-Qt

Базовый ввод

ComboBox Выпадающий список

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

Пример

ComboBox Выпадающий список: Выбор в 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());
        });

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 = 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: QComboBox

fluent::basicinput::ComboBoxItemDelegate

Наследует QStyledItemDelegate

Делегат элементов, отрисовывающий строки всплывающего списка ComboBox с метриками и цветами темы Fluent.

Конструкторы

Методы