Компоновка
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);import fluentqt
from PySide6.QtWidgets import QVBoxLayout, QWidget
accordion = fluentqt.Accordion()
accordion.setExpansionMode(fluentqt.Accordion.ExpansionMode.Single)
accordion.setFixedWidth(520)
def make_section(title, detail):
item = fluentqt.Expander()
item.setHeaderText(title)
body = QWidget()
body_layout = QVBoxLayout(body)
body_layout.setContentsMargins(16, 12, 16, 14)
body_layout.addWidget(
fluentqt.Label("Additional details", body)
)
body_layout.addWidget(fluentqt.Label(detail, body))
item.setOwnedContentWidget(body)
return item
account = make_section("Account", "Profile, sign-in, and recovery options.")
notifications = make_section(
"Notifications",
"Choose which activity can interrupt you."
)
privacy = make_section(
"Privacy",
"Review diagnostics and personalization settings."
)
accordion.addOwnedItem(account)
accordion.addOwnedItem(notifications)
accordion.addOwnedItem(privacy)
account.setExpandedAnimated(True, False)API
ОбъявлениеНет подходящих элементов API.
fluent::layout::Accordion
Наследует QWidget · FluentElement · QMLPlus
Вертикальный контейнер элементов Expander с согласованным раскрытием и навигацией с клавиатуры. По умолчанию используется WidgetOwnership::Borrowed; передайте WidgetOwnership для восстановления или передачи управления удалением элементов.
Конструкторы
Деструкторы
Перечисления
enum class ExpansionModeОпределяет, могут ли быть раскрыты один или несколько элементов.
SingleMultiple
Методы
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 = 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