Компоновка
ListDetailView Представление списка и сведений
Отображает список и область сведений рядом друг с другом или по одной панели в узком окне. Одни и те же виджеты содержимого сохраняются при смене макета.
Пример
Не удалось загрузить предпросмотр свойств. Выберите предпросмотр свойств ещё раз для повтора.

Использование
Одна или две панели
Выберите Narrow preview, откройте заметку о встрече и отредактируйте текст. Вернитесь к списку заметок или переключитесь на Wide preview: та же заметка сохранит ваши изменения.
#include <FluentQt/Layout.h>
using namespace fluent::layout;
auto* panel = new QWidget(this);
auto* body = new QVBoxLayout(panel);
body->setContentsMargins(0, 0, 0, 0);
body->setSpacing(12);
auto* width = new ComboBox(panel);
width->setAccessibleName("Preview width");
width->addItems({"Wide preview", "Narrow preview"});
body->addWidget(width, 0, Qt::AlignLeft);
auto* view = new fluent::layout::ListDetailView(panel);
view->setCompactThreshold(520);
view->setMaximumWidth(640);
view->setFixedHeight(156);
body->addWidget(view, 0, Qt::AlignLeft);
auto* list = new QVBoxLayout(view->listPane());
list->addWidget(new Label("Notes", view->listPane()));
auto* open = new Button("Open meeting note", view->listPane());
list->addWidget(open);
list->addStretch();
auto* detail = new QVBoxLayout(view->detailPane());
auto* back = new Button("Back to notes", view->detailPane());
back->setFluentStyle(Button::Subtle);
back->setVisible(view->isCompact());
detail->addWidget(back, 0, Qt::AlignLeft);
detail->addWidget(new Label("Meeting note", view->detailPane()));
auto* editor = new LineEdit(view->detailPane());
editor->setAccessibleName("Note draft");
editor->setText("Discuss the next release");
detail->addWidget(editor);
detail->addStretch();
connect(open, &Button::clicked, view, &fluent::layout::ListDetailView::showDetail);
connect(back, &Button::clicked, view, &fluent::layout::ListDetailView::showList);
connect(view, &fluent::layout::ListDetailView::compactChanged, back, &QWidget::setVisible);
connect(width, qOverload<int>(&ComboBox::currentIndexChanged), view, [view](int index) {
view->setMaximumWidth(index == 0 ? 640 : 360);
});import fluentqt
from PySide6.QtCore import Qt
from PySide6.QtWidgets import QVBoxLayout, QWidget
panel = QWidget()
body = QVBoxLayout(panel)
body.setContentsMargins(0, 0, 0, 0)
body.setSpacing(12)
width = fluentqt.ComboBox(panel)
width.setObjectName("listDetailPreviewWidth")
width.setAccessibleName("Preview width")
width.addItems(["Wide preview", "Narrow preview"])
body.addWidget(width, 0, Qt.AlignLeft)
view = fluentqt.ListDetailView(panel)
view.setObjectName("basicListDetailView")
view.setCompactThreshold(520)
view.setMaximumWidth(640)
view.setFixedHeight(156)
body.addWidget(view, 0, Qt.AlignLeft)
list_layout = QVBoxLayout(view.listPane())
list_layout.addWidget(fluentqt.Label("Notes", view.listPane()))
open_button = fluentqt.Button("Open meeting note", view.listPane())
list_layout.addWidget(open_button)
list_layout.addStretch()
detail_layout = QVBoxLayout(view.detailPane())
back = fluentqt.Button("Back to notes", view.detailPane())
back.setFluentStyle(fluentqt.Button.Subtle)
back.setVisible(view.isCompact())
detail_layout.addWidget(back, 0, Qt.AlignLeft)
detail_layout.addWidget(fluentqt.Label("Meeting note", view.detailPane()))
editor = fluentqt.LineEdit(view.detailPane())
editor.setAccessibleName("Note draft")
editor.setText("Discuss the next release")
detail_layout.addWidget(editor)
detail_layout.addStretch()
open_button.clicked.connect(view.showDetail)
back.clicked.connect(view.showList)
view.compactChanged.connect(back.setVisible)
width.currentIndexChanged.connect(
lambda index: view.setMaximumWidth(640 if index == 0 else 360)
)API
ОбъявлениеНет подходящих элементов API.
fluent::layout::ListDetailView
Наследует QWidget · FluentElement · QMLPlus
Две постоянные панели, переключающиеся в однопанельный режим при ширине ниже пороговой.
Конструкторы
Перечисления
enum PaneАктивный раздел в компактном режиме; в широком режиме отображаются обе панели.
ListDetail
Методы
QWidget* listPane() constВозвращает контейнер панели списка, принадлежащий представлению.
QWidget* detailPane() constВозвращает контейнер панели деталей, принадлежащий представлению.
void setCompactThreshold(int width)Задаёт ширину, ниже которой отображается только currentPane; минимум 1.
void setListPaneWidth(int width)Задаёт ширину широкого списка, ограниченную половиной доступной ширины.
Свойства
bool compact- Чтение
isCompact()УведомлениеcompactChanged() int compactThreshold- Чтение
compactThreshold()ЗаписьsetCompactThreshold()УведомлениеcompactThresholdChanged() int listPaneWidth- Чтение
listPaneWidth()ЗаписьsetListPaneWidth()УведомлениеlistPaneWidthChanged() Pane currentPane- Чтение
currentPane()ЗаписьsetCurrentPane()УведомлениеcurrentPaneChanged()
Сигналы
Защищённые члены
Методы
Унаследовано от 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