Fluent-Qt

Компоновка

Accordion Аккордеон

Управляет вертикальной группой раскрывающихся секций с одиночным или множественным раскрытием.

Пример

Accordion Аккордеон: Одиночное раскрытие

Использование

Одиночное раскрытие

В одиночном режиме открытие другого заголовка сворачивает предыдущую секцию.

#include <FluentQt/Layout.h>
using namespace fluent::layout;

auto* accordion = new Accordion(this);
accordion->setExpansionMode(
    Accordion::ExpansionMode::Single);
accordion->setFixedWidth(520);

auto makeSection = [](const QString& title,
                     const QString& detail) {
    auto* item = new Expander;
    item->setHeaderText(title);
    auto* body = new QWidget;
    auto* bodyLayout = new QVBoxLayout(body);
    bodyLayout->setContentsMargins(16, 12, 16, 14);
    bodyLayout->addWidget(
        new Label("Additional details", body));
    bodyLayout->addWidget(new Label(detail, body));
    item->setContentWidget(
        body, WidgetOwnership::Owned);
    return item;
};

accordion->addItem(
    makeSection("Account",
        "Profile, sign-in, and recovery options."),
    WidgetOwnership::Owned);
accordion->addItem(
    makeSection("Notifications",
        "Choose which activity can interrupt you."),
    WidgetOwnership::Owned);
accordion->addItem(
    makeSection("Privacy",
        "Review diagnostics and personalization settings."),
    WidgetOwnership::Owned);
accordion->itemAt(0)->setExpandedAnimated(true, false);

fluent::layout::Accordion

Наследует QWidget · FluentElement · QMLPlus

Вертикальный контейнер элементов Expander с согласованным раскрытием и навигацией с клавиатуры. По умолчанию используется WidgetOwnership::Borrowed; передайте WidgetOwnership для восстановления или передачи управления удалением элементов.

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

Деструкторы

Перечисления

enum class ExpansionMode

Определяет, могут ли быть раскрыты один или несколько элементов.

  • Single
  • Multiple

Методы

bool addItem(Expander* item)

Добавляет элемент Expander (WidgetOwnership::Borrowed; не удаляется Accordion).

bool addItem(Expander* item, WidgetOwnership ownership)

Добавляет элемент Expander с указанным режимом очистки WidgetOwnership.

bool insertItem(int index, Expander* item)

Вставляет элемент Expander по индексу (WidgetOwnership::Borrowed; не удаляется компонентом Accordion).

bool insertItem(int index, Expander* item, WidgetOwnership ownership)

Вставляет элемент Expander по индексу с указанным режимом очистки WidgetOwnership.

bool removeItem(int index)

Удаляет элемент по индексу и выполняет очистку согласно его режиму WidgetOwnership.

Expander* takeItem(int index)

Извлекает и возвращает элемент по индексу для управления или удаления вызывающим кодом.

Свойства

ExpansionMode expansionMode
Чтение expansionMode()Запись setExpansionMode()Уведомление expansionModeChanged()
int count
Чтение count()Уведомление countChanged()

Сигналы

Дополнения PySide6

addOwnedItem(item)

Добавляет в конец элемент, который уничтожается вместе с Accordion.

addBorrowedItem(item)

Добавляет в конец элемент, который при освобождении отсоединяется от родителя.

addReparentedItem(item)

Добавляет в конец элемент, который при освобождении возвращается к прежнему родительскому QWidget.

insertOwnedItem(index, item)

Вставляет элемент, который уничтожается вместе с Accordion.

insertBorrowedItem(index, item)

Вставляет элемент, который при освобождении отсоединяется от родителя.

insertReparentedItem(index, item)

Вставляет элемент, который при освобождении возвращается к прежнему родительскому QWidget.

Защищённые члены

Методы

Унаследовано от 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