minor tweaks

Sine Striker

2024-05-08 49b27d64a9778d53a3accd9bfbfbc3ee1a1a7178

 src/core/windowagentbase.cpp

@@ -1,10 +1,18 @@
// Copyright (C) 2023-2024 Stdware Collections (https://www.github.com/stdware)
// Copyright (C) 2021-2023 wangwenx190 (Yuhang Zhao)
// SPDX-License-Identifier: Apache-2.0

#include "windowagentbase.h"
#include "windowagentbase_p.h"

#include <QWKCore/qwkconfig.h>

#include "qwkglobal_p.h"

#ifdef Q_OS_WINDOWS
#if defined(Q_OS_WINDOWS) && !QWINDOWKIT_CONFIG(ENABLE_QT_WINDOW_CONTEXT)
#  include "win32windowcontext_p.h"
#elif defined(Q_OS_MAC) && !QWINDOWKIT_CONFIG(ENABLE_QT_WINDOW_CONTEXT)
#  include "cocoawindowcontext_p.h"
#else
#  include "qtwindowcontext_p.h"
#endif
@@ -12,6 +20,20 @@
Q_LOGGING_CATEGORY(qWindowKitLog, "qwindowkit")

namespace QWK {

    /*!
        \namespace QWK
        \brief QWindowKit namespace
    */

    /*!
        \class WindowAgentBase
        \brief WindowAgentBase is the base class of the specifiy window agent for QtWidgets and
        QtQuick.

        It processes some system events to remove the window's default title bar, and provides some
        shared methods for derived classes to call.
    */

    WindowAgentBasePrivate::WindowContextFactoryMethod
        WindowAgentBasePrivate::windowContextFactoryMethod = nullptr;
@@ -28,57 +50,97 @@
        if (windowContextFactoryMethod) {
            return windowContextFactoryMethod();
        }
#ifdef Q_OS_WINDOWS

#if defined(Q_OS_WINDOWS) && !QWINDOWKIT_CONFIG(ENABLE_QT_WINDOW_CONTEXT)
        return new Win32WindowContext();
#elif defined(Q_OS_MAC) && !QWINDOWKIT_CONFIG(ENABLE_QT_WINDOW_CONTEXT)
        return new CocoaWindowContext();
#else
        return new QtWindowContext();
#endif
    }

    bool WindowAgentBasePrivate::setup(QObject *host, WindowItemDelegate *delegate) {
        std::unique_ptr<AbstractWindowContext> ctx(createContext());
        if (!ctx->setup(host, delegate)) {
            return false;
        }
        context = std::move(ctx);
        return true;
    void WindowAgentBasePrivate::setup(QObject *host, WindowItemDelegate *delegate) {
        auto ctx = createContext();
        ctx->setup(host, delegate);
        context.reset(ctx);
    }

    /*!
        Destructor.
    */
    WindowAgentBase::~WindowAgentBase() = default;

    /*!
        Returns the window attribute value.

        \sa setWindowAttribute()
    */
    QVariant WindowAgentBase::windowAttribute(const QString &key) const {
        Q_D(const WindowAgentBase);
        return d->context->windowAttribute(key);
    }

    /*!
        Sets the platform-related attribute for the window. Available attributes:

        On Windows,
            \li \c dwm-blur: Specify a boolean value to enable or disable dwm blur effect, this
                   attribute is available on Windows 10 or later.
            \li \c dark-mode: Specify a boolean value to enable or disable the dark mode, it is
                   enabled by default on Windows 10 if the system borders config is enabled. This
                   attribute is available on Windows 10 or later.
            \li \c acrylic-material: Specify a boolean value to enable or disable acrylic material,
                   this attribute is only available on Windows 11.
            \li \c mica: Specify a boolean value to enable or disable mica material,
                   this attribute is only available on Windows 11.
            \li \c mica-alt: Specify a boolean value to enable or disable mica-alt material,
                   this attribute is only available on Windows 11.
            \li \c extra-margins: Specify a margin value to change the \c dwm extended area
                   geometry, you shouldn't change this attribute because it may break the
                   internal state.

        On macOS,
            \li \c no-system-buttons: Specify a boolean value to set the system buttons'
                   visibility.
            \li \c blur-effect: You can specify a string value, "dark" to enable dark mode, "light"
                   to set enable mode, "none" to disable. You can also specify a boolean value,
                   \c true to enable current theme mode, \c false to disable.
            \li \c title-bar-height: Returns the system title bar height, the system button display
                   area will be limited to this height. (Readonly)
    */
    bool WindowAgentBase::setWindowAttribute(const QString &key, const QVariant &attribute) {
        Q_D(WindowAgentBase);
        return d->context->setWindowAttribute(key, attribute);
    }

    /*!
        Shows the system menu, it's only implemented on Windows.
    */
    void WindowAgentBase::showSystemMenu(const QPoint &pos) {
        Q_D(WindowAgentBase);
        d->context->showSystemMenu(pos);
    }

    void WindowAgentBase::startSystemMove(const QPoint &pos) {
        Q_D(WindowAgentBase);
        auto win = d->context->window();
        if (!win) {
            return;
        }

        Q_UNUSED(pos)
        win->startSystemMove();
    }

    void WindowAgentBase::startSystemResize(Qt::Edges edges, const QPoint &pos) {
        Q_D(WindowAgentBase);
        auto win = d->context->window();
        if (!win) {
            return;
        }

        Q_UNUSED(pos)
        win->startSystemResize(edges);
    }

    /*!
        Makes the window show in center of the current screen.
    */
    void WindowAgentBase::centralize() {
        Q_D(WindowAgentBase);
        d->context->virtual_hook(AbstractWindowContext::CentralizeHook, nullptr);
    }

    /*!
        Brings the window to top.
    */
    void WindowAgentBase::raise() {
        Q_D(WindowAgentBase);
        d->context->virtual_hook(AbstractWindowContext::RaiseWindowHook, nullptr);
    }

    /*!
        \internal
    */
    WindowAgentBase::WindowAgentBase(WindowAgentBasePrivate &d, QObject *parent)
        : QObject(parent), d_ptr(&d) {
        d.q_ptr = this;