Fluent-Qt

Справочник API

WindowChromeCompat

Кроссплатформенный адаптер поведения оформления окна, проверки попаданий и системных фонов.

compatibility::WindowChromeOptions

Параметры интеграции с системным оформлением окна.

Поля

QRect titleBarRect

Перетаскиваемая область строки заголовка в локальных координатах окна.

QVector<QRect> dragExclusionRects

Прямоугольники дочерних элементов в строке заголовка, остающиеся обычной клиентской областью.

int resizeBorderWidth = 8

Ширина границы проверки попадания для изменения размера в аппаратно-независимых пикселях.

bool useCustomWindowChrome = false

Включает интеграцию пользовательской строки заголовка Fluent с приоритетом нативного управления окном там, где оно поддерживается.

bool preferNativeMacControls = true

Сохраняет нативные кнопки управления окном macOS («светофор»), если они доступны.

bool chromeInteractive = true

Блокирует перемещение и изменение размера окна при значении false (например, пока активно модальное перекрытие).

QPointer<QAbstractButton> maximizeButton

Кнопка разворачивания/восстановления, используемая для нативной проверки попадания в заголовок.

compatibility::WindowChromeCompat

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

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

enum class Platform

Семейство платформ времени выполнения для выбора политики оформления окна.

  • Windows
  • MacOS
  • Linux
  • Other
enum class HitTest

Логический результат проверки попадания, сопоставляемый с платформенными кодами попадания.

  • Client
  • Caption
  • Left
  • Right
  • Top
  • Bottom
  • TopLeft
  • TopRight
  • BottomLeft
  • BottomRight

Методы

void configure(const WindowChromeOptions& options)

Обновляет параметры рамки окна и синхронизирует геометрию системного заголовка.

void applyPlatformWindowFlags()

Применяет флаги окна платформы, требуемые текущей конфигурацией оформления окна.

bool systemBackdropSupported() const

Поддерживает ли текущая платформа полупрозрачный системный фон.

BackdropCapabilities backdropCapabilities() const

Возвращает возможности платформы по эффектам для текущего сеанса.

bool applySystemBackdrop(BackdropEffect effect, bool dark, bool forceRecomposite = false)

Применяет запрошенный системный эффект фона (устаревший метод; используйте applySystemBackdropDetailed() для получения сведений о выбранном бэкенде).

BackdropApplyResult applySystemBackdropDetailed(BackdropEffect effect, bool dark, bool forceRecomposite = false)

Применяет фоновый эффект и возвращает выбранный бэкенд, степень точности и причину отката.

bool handleNativeEvent(const QByteArray& eventType, void* message, FluentNativeEventResult* result)

Обрабатывает перенаправленные нативные события и возвращает true, если событие обработано.

bool beginSystemMove(const QPoint& globalPos)

Запускает системную операцию перемещения окна платформы.

bool beginSystemResize(Qt::Edges edges, const QPoint& globalPos)

Запускает системную операцию изменения размера окна платформы для заданных краёв.

bool performTitleBarDoubleClick()

Выполняет стандартное для платформы действие по двойному щелчку на строке заголовка.

bool showSystemMenu(const QPoint& globalPos)

Показывает системное меню платформы в заданной глобальной позиции.

bool requestForegroundActivation()

Запрашивает активацию на переднем плане через оконный менеджер платформы.

HitTest hitTestLocal(const QPoint& localPos) const

Классифицирует локальную точку по настроенным областям заголовка и изменения размера.

compatibility

Типы и псевдонимы

using FluentNativeEventResult = qintptr

Тип результата нативного события, используемый QWidget::nativeEvent() в разных версиях Qt.