sola/qwindowkit.git

			@@ -1,3 +1,7 @@
			// 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"

			@@ -5,9 +9,9 @@

			#include "qwkglobal_p.h"

			#if defined(Q_OS_WINDOWS) && !QWINDOWKIT_CONFIG(FORCE_QT_WINDOW_CONTEXT)
			#if defined(Q_OS_WINDOWS) && !QWINDOWKIT_CONFIG(ENABLE_QT_WINDOW_CONTEXT)
			# include "win32windowcontext_p.h"
			#elif defined(Q_OS_MAC) && !QWINDOWKIT_CONFIG(FORCE_QT_WINDOW_CONTEXT)
			#elif defined(Q_OS_MAC) && !QWINDOWKIT_CONFIG(ENABLE_QT_WINDOW_CONTEXT)
			# include "cocoawindowcontext_p.h"
			#else
			# include "qtwindowcontext_p.h"
			@@ -16,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;
			@@ -33,9 +51,9 @@
			return windowContextFactoryMethod();
			}

			#if defined(Q_OS_WINDOWS) && !QWINDOWKIT_CONFIG(FORCE_QT_WINDOW_CONTEXT)
			#if defined(Q_OS_WINDOWS) && !QWINDOWKIT_CONFIG(ENABLE_QT_WINDOW_CONTEXT)
			return new Win32WindowContext();
			#elif defined(Q_OS_MAC) && !QWINDOWKIT_CONFIG(FORCE_QT_WINDOW_CONTEXT)
			#elif defined(Q_OS_MAC) && !QWINDOWKIT_CONFIG(ENABLE_QT_WINDOW_CONTEXT)
			return new CocoaWindowContext();
			#else
			return new QtWindowContext();
			@@ -48,47 +66,85 @@
			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);
			}

			void WindowAgentBase::setWindowAttribute(const QString &key, const QVariant &var) {
			/*!
			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.
			\li \c border-thickness: Returns the system border thickness. (Readonly)
			\li \c title-bar-height: Returns the system title bar height, some system features may
			be related to this property so that it is recommended to set the custom title bar
			height to this value. (Readonly)

			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);
			d->context->setWindowAttribute(key, var);
			return d->context->setWindowAttribute(key, attribute);
			}

			bool WindowAgentBase::isEnabled() const {
			Q_D(const WindowAgentBase);
			return d->context->isEnabled();
			}

			void WindowAgentBase::setEnabled(bool enabled) {
			Q_D(WindowAgentBase);
			if (enabled == d->context->isEnabled()) {
			return;
			}
			d->context->setEnabled(enabled);
			Q_EMIT enabledChanged(enabled);
			}

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

			/*!
			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;