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