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

Использование
Контейнер содержимого верхнего уровня
Задайте содержимое окна через setContentWidget(), запросите эффект Mica или Acrylic с помощью setBackdropEffect() и проверьте активный фон платформы через backdropState().
#include <FluentQt/Windowing.h>
using namespace fluent::windowing;
auto* window = new Window();
window->setAttribute(Qt::WA_DeleteOnClose);
window->setWindowTitle("Fluent window");
window->setCustomWindowChromeEnabled(true);
window->setBackdropEffect(BackdropEffect::Mica);
auto* content = new QWidget();
content->setAutoFillBackground(false);
window->setContentWidget(content);
window->resize(640, 520);
window->show();import fluentqt
from PySide6.QtCore import Qt
from PySide6.QtWidgets import QWidget
window = fluentqt.Window()
window.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose, True)
window.setWindowTitle("Fluent window")
window.setCustomWindowChromeEnabled(True)
window.setBackdropEffect(fluentqt.BackdropEffect.Mica)
content = QWidget()
content.setAutoFillBackground(False)
window.setContentWidget(content)
window.resize(640, 520)
window.show()API
ОбъявлениеНет подходящих элементов API.
fluent::windowing::Window
Наследует QWidget · FluentElement · QMLPlus
Окно-оболочка приложения с заголовком и областью содержимого; по умолчанию использует нативное управление окном, а при отсутствии поддержки — клиентскую рамку.
Конструкторы
Деструкторы
Методы
QRect chromeFrameRect() constГраницы видимой рамки окна в локальных координатах без учёта внешних полей тени.
QWidget* contentWidget() constВиджет, размещённый в области содержимого окна.
void setContentWidget(QWidget* widget)Задаёт виджет содержимого окна без принятия владения.
void setCustomWindowChromeEnabled(bool enabled)Включает или отключает интеграцию пользовательской строки заголовка; нативные перемещение и изменение размера остаются предпочтительными там, где поддерживаются.
void reapplySystemBackdrop()Повторно запрашивает возможности платформы и повторно применяет настроенный фон.
void setVisible(bool visible) overrideПоказывает или скрывает окно, сохраняя развёрнутую геометрию при показе в развёрнутом виде (включая macOS Stage Manager).
void prepareForNativeRestore()Сбрасывает временное состояние кнопок заголовка и повторно применяет нативное оформление окна перед восстановлением скрытого окна.
void requestForegroundActivation()Поднимает окно и запрашивает его активацию на переднем плане.
void setBackdropEffect(BackdropEffect effect)Переключает полупрозрачный фоновый эффект окна без его пересоздания.
BackdropState backdropState() constРазрешённое состояние фона, фактически используемое окном.
BackdropCapabilities backdropCapabilities() constЭффекты фона, поддерживаемые в текущей сессии платформы.
void setChromeInteractive(bool interactive)Включает или отключает перетаскивание окна пользователем и изменение размера за края (например, пока открыто модальное наложение).
void setCaptionButtonToolTips(const QString& minimizeTooltip, const QString& maximizeTooltip, const QString& closeTooltip, const QString& restoreTooltip = QString())Задаёт всплывающие подсказки для кнопок сворачивания, разворачивания, закрытия и восстановления; пустые строки скрывают их.
void setCaptionButtonAccessibleNames(const QString& minimizeName, const QString& maximizeName, const QString& closeName, const QString& restoreName = QString())Задаёт имена доступности для кнопок заголовка окна (по умолчанию пустые).
Свойства
QWidget* contentWidgetВиджет, размещённый в области содержимого окна.
ЧтениеcontentWidget()ЗаписьsetContentWidget()BackdropEffect backdropEffect- Чтение
backdropEffect()ЗаписьsetBackdropEffect()УведомлениеbackdropEffectChanged()
Сигналы
Защищённые члены
Методы
Унаследовано от 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