chore: baseline usable version

libs/qwindowkit/examples/shared/CMakeLists.txt

@@ -0,0 +1 @@
+add_subdirectory(widgetframe)

libs/qwindowkit/examples/shared/resources/shared.qrc

@@ -0,0 +1,13 @@
+<RCC>
+    <qresource prefix="/">
+        <file>window-bar/close.svg</file>
+        <file>window-bar/fullscreen.svg</file>
+        <file>window-bar/maximize.svg</file>
+        <file>window-bar/minimize.svg</file>
+        <file>window-bar/restore.svg</file>
+        <file>window-bar/more-line.svg</file>
+        <file>window-bar/pin.svg</file>
+        <file>window-bar/pin-fill.svg</file>
+        <file>app/example.png</file>
+    </qresource>
+</RCC>

libs/qwindowkit/examples/shared/resources/window-bar/close.svg

@@ -0,0 +1,15 @@
+<svg id="图层_1" data-name="图层 1" xmlns="http://www.w3.org/2000/svg" width="10.88" height="10.88"
+  viewBox="0 0 10.88 10.88">
+  <defs>
+    <style>
+      .cls-1 {
+        fill: none;
+        stroke: white;
+        stroke-miterlimit: 10;
+        stroke-width: 1.25px;
+      }
+    </style>
+  </defs>
+  <line class="cls-1" x1="0.44" y1="0.44" x2="10.44" y2="10.44" />
+  <line class="cls-1" x1="0.44" y1="10.44" x2="10.44" y2="0.44" />
+</svg>

libs/qwindowkit/examples/shared/resources/window-bar/fullscreen.svg

@@ -0,0 +1,11 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg t="1594017175519"
+    class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="1933"
+    xmlns:xlink="http://www.w3.org/1999/xlink" width="16" height="16">
+    <defs>
+        <style type="text/css"></style>
+    </defs>
+    <path
+        d="M874.666667 128h-170.666667a21.333333 21.333333 0 0 0 0 42.666667h119.168l-176.917333 176.917333a21.333333 21.333333 0 1 0 30.165333 30.165333L853.333333 200.832V320a21.333333 21.333333 0 0 0 42.666667 0V149.333333a21.333333 21.333333 0 0 0-21.333333-21.333333zM347.584 646.250667L170.666667 823.168V704a21.333333 21.333333 0 0 0-42.666667 0v170.666667a21.333333 21.333333 0 0 0 21.333333 21.333333h170.666667a21.333333 21.333333 0 0 0 0-42.666667H200.832l176.917333-176.917333a21.333333 21.333333 0 0 0-30.165333-30.165333zM874.666667 682.666667a21.333333 21.333333 0 0 0-21.333334 21.333333v119.168l-176.917333-176.917333a21.333333 21.333333 0 0 0-30.165333 30.165333L823.168 853.333333H704a21.333333 21.333333 0 0 0 0 42.666667h170.666667a21.333333 21.333333 0 0 0 21.333333-21.333333v-170.666667a21.333333 21.333333 0 0 0-21.333333-21.333333zM200.832 170.666667H320a21.333333 21.333333 0 0 0 0-42.666667H149.333333a21.333333 21.333333 0 0 0-21.333333 21.333333v170.666667a21.333333 21.333333 0 0 0 42.666667 0V200.832l176.917333 176.917333a21.333333 21.333333 0 0 0 30.165333-30.165333z"
+        fill="#ffffff" p-id="1934"></path>
+</svg>

libs/qwindowkit/examples/shared/resources/window-bar/maximize.svg

@@ -0,0 +1,12 @@
+<svg id="图层_1" data-name="图层 1" xmlns="http://www.w3.org/2000/svg" width="10" height="10" viewBox="0 0 10 10">
+  <defs>
+    <style>
+      .cls-1 {
+        fill: none;
+        stroke: white;
+        stroke-miterlimit: 10;
+      }
+    </style>
+  </defs>
+  <rect class="cls-1" x="0.5" y="0.5" width="9" height="9" />
+</svg>

libs/qwindowkit/examples/shared/resources/window-bar/minimize.svg

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 24.3.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="图层_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px"
+	y="0px" viewBox="0 0 10 10" style="enable-background:new 0 0 10 10;" xml:space="preserve">
+	<style type="text/css">
+		.st0 {
+			fill: white;
+		}
+	</style>
+	<rect y="4.5" class="st0" width="10" height="1" />
+</svg>

libs/qwindowkit/examples/shared/resources/window-bar/more-line.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24">
+    <path fill="none" d="M0 0h24v24H0z" />
+    <path fill="white"
+        d="M4.5 10.5c-.825 0-1.5.675-1.5 1.5s.675 1.5 1.5 1.5S6 12.825 6 12s-.675-1.5-1.5-1.5zm15 0c-.825 0-1.5.675-1.5 1.5s.675 1.5 1.5 1.5S21 12.825 21 12s-.675-1.5-1.5-1.5zm-7.5 0c-.825 0-1.5.675-1.5 1.5s.675 1.5 1.5 1.5 1.5-.675 1.5-1.5-.675-1.5-1.5-1.5z" />
+</svg>

libs/qwindowkit/examples/shared/resources/window-bar/pin-fill.svg

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg t="1735286082742" class="icon" viewBox="0 0 1024 1024" version="1.1"
+    xmlns="http://www.w3.org/2000/svg" p-id="2501" width="512" height="512"
+    xmlns:xlink="http://www.w3.org/1999/xlink">
+    <path
+        d="M648.728381 130.779429a73.142857 73.142857 0 0 1 22.674286 15.433142l191.561143 191.756191a73.142857 73.142857 0 0 1-22.137905 118.564571l-67.876572 30.061715-127.341714 127.488-10.093714 140.239238a73.142857 73.142857 0 0 1-124.684191 46.445714l-123.66019-123.782095-210.724572 211.699809-51.833904-51.614476 210.846476-211.821714-127.926857-128.024381a73.142857 73.142857 0 0 1 46.299428-124.635429l144.237715-10.776381 125.074285-125.220571 29.379048-67.779048a73.142857 73.142857 0 0 1 96.207238-38.034285z"
+        p-id="2502" fill="white"></path>
+</svg>

libs/qwindowkit/examples/shared/resources/window-bar/pin.svg

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg t="1735285955420" class="icon" viewBox="0 0 1024 1024" version="1.1"
+    xmlns="http://www.w3.org/2000/svg" p-id="2053" width="512" height="512"
+    xmlns:xlink="http://www.w3.org/1999/xlink">
+    <path
+        d="M648.728381 130.779429a73.142857 73.142857 0 0 1 22.674286 15.433142l191.561143 191.756191a73.142857 73.142857 0 0 1-22.137905 118.564571l-67.876572 30.061715-127.341714 127.488-10.093714 140.239238a73.142857 73.142857 0 0 1-124.684191 46.445714l-123.66019-123.782095-210.724572 211.699809-51.833904-51.614476 210.846476-211.821714-127.926857-128.024381a73.142857 73.142857 0 0 1 46.299428-124.635429l144.237715-10.776381 125.074285-125.220571 29.379048-67.779048a73.142857 73.142857 0 0 1 96.207238-38.034285z m-29.086476 67.120761l-34.913524 80.530286-154.087619 154.331429-171.398095 12.751238 303.323428 303.542857 12.044191-167.399619 156.233143-156.428191 80.384-35.59619-191.585524-191.73181z"
+        p-id="2054" fill="white"></path>
+</svg>

libs/qwindowkit/examples/shared/resources/window-bar/restore.svg

@@ -0,0 +1,16 @@
+<svg id="图层_1" data-name="图层 1" xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 12 12">
+  <defs>
+    <style>
+      .cls-1 {
+        fill: none;
+        stroke: white;
+        stroke-miterlimit: 10;
+      }
+    </style>
+  </defs>
+  <rect class="cls-1" x="0.5" y="2.5" width="9" height="9" />
+  <line class="cls-1" x1="2.5" y1="2.5" x2="2.5" y2="0.5" />
+  <line class="cls-1" x1="12" y1="0.5" x2="2" y2="0.5" />
+  <line class="cls-1" x1="11.5" y1="10" x2="11.5" />
+  <line class="cls-1" x1="10" y1="9.5" x2="12" y2="9.5" />
+</svg>

libs/qwindowkit/examples/shared/widgetframe/CMakeLists.txt

@@ -0,0 +1,17 @@
+project(WidgetFrame)
+
+set(CMAKE_AUTOMOC ON)
+set(CMAKE_AUTOUIC ON)
+set(CMAKE_AUTORCC ON)
+
+file(GLOB _src *.h *.cpp)
+
+add_library(${PROJECT_NAME} STATIC)
+
+qm_configure_target(${PROJECT_NAME}
+    FEATURES cxx_std_17
+    SOURCES ${_src}
+    QT_LINKS Core Gui Widgets
+)
+
+target_include_directories(${PROJECT_NAME} PUBLIC . ..)

libs/qwindowkit/examples/shared/widgetframe/windowbar.cpp

@@ -0,0 +1,408 @@
+// 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 "windowbar.h"
+#include "windowbar_p.h"
+
+#include <QtCore/QDebug>
+#include <QtCore/QLocale>
+#include <QtGui/QtEvents>
+
+namespace QWK {
+
+    WindowBarPrivate::WindowBarPrivate() {
+        w = nullptr;
+        autoTitle = true;
+        autoIcon = false;
+    }
+
+    WindowBarPrivate::~WindowBarPrivate() = default;
+
+    void WindowBarPrivate::init() {
+        Q_Q(WindowBar);
+        layout = new QHBoxLayout();
+        if (QLocale::system().textDirection() == Qt::RightToLeft) {
+            layout->setDirection(QBoxLayout::RightToLeft);
+        }
+
+        layout->setContentsMargins(QMargins());
+        layout->setSpacing(0);
+        for (int i = IconButton; i <= CloseButton; ++i) {
+            insertDefaultSpace(i);
+        }
+        q->setLayout(layout);
+    }
+
+    void WindowBarPrivate::setWidgetAt(int index, QWidget *widget) {
+        auto item = layout->takeAt(index);
+        auto orgWidget = item->widget();
+        if (orgWidget) {
+            orgWidget->deleteLater();
+        }
+        delete item;
+        if (!widget) {
+            insertDefaultSpace(index);
+        } else {
+            layout->insertWidget(index, widget);
+        }
+    }
+
+    QWidget *WindowBarPrivate::takeWidgetAt(int index) {
+        auto item = layout->itemAt(index);
+        auto orgWidget = item->widget();
+        if (orgWidget) {
+            item = layout->takeAt(index);
+            delete item;
+            insertDefaultSpace(index);
+        }
+        return orgWidget;
+    }
+
+    WindowBar::WindowBar(QWidget *parent) : WindowBar(*new WindowBarPrivate(), parent) {
+    }
+
+    WindowBar::~WindowBar() = default;
+
+    QMenuBar *WindowBar::menuBar() const {
+        Q_D(const WindowBar);
+        return static_cast<QMenuBar *>(d->widgetAt(WindowBarPrivate::MenuWidget));
+    }
+
+    QLabel *WindowBar::titleLabel() const {
+        Q_D(const WindowBar);
+        return static_cast<QLabel *>(d->widgetAt(WindowBarPrivate::TitleLabel));
+    }
+
+    QAbstractButton *WindowBar::iconButton() const {
+        Q_D(const WindowBar);
+        return static_cast<QAbstractButton *>(d->widgetAt(WindowBarPrivate::IconButton));
+    }
+
+    QAbstractButton *WindowBar::backButton() const {
+        Q_D(const WindowBar);
+        return static_cast<QAbstractButton *>(d->widgetAt(WindowBarPrivate::BackButton));
+    }
+
+    QAbstractButton *WindowBar::homeButton() const {
+        Q_D(const WindowBar);
+        return static_cast<QAbstractButton *>(d->widgetAt(WindowBarPrivate::HomeButton));
+    }
+
+    QAbstractButton *WindowBar::favButton() const {
+        Q_D(const WindowBar);
+        return static_cast<QAbstractButton *>(d->widgetAt(WindowBarPrivate::FavButton));
+    }
+
+    QWidget *WindowBar::centerWidget() const {
+        Q_D(const WindowBar);
+        return d->widgetAt(WindowBarPrivate::CenterWidget);
+    }
+
+    QAbstractButton *WindowBar::pinButton() const {
+        Q_D(const WindowBar);
+        return static_cast<QAbstractButton *>(d->widgetAt(WindowBarPrivate::PinButton));
+    }
+
+    QAbstractButton *WindowBar::minButton() const {
+        Q_D(const WindowBar);
+        return static_cast<QAbstractButton *>(d->widgetAt(WindowBarPrivate::MinimizeButton));
+    }
+
+    QAbstractButton *WindowBar::maxButton() const {
+        Q_D(const WindowBar);
+        return static_cast<QAbstractButton *>(d->widgetAt(WindowBarPrivate::MaximizeButton));
+    }
+
+    QAbstractButton *WindowBar::closeButton() const {
+        Q_D(const WindowBar);
+        return static_cast<QAbstractButton *>(d->widgetAt(WindowBarPrivate::CloseButton));
+    }
+
+    void WindowBar::setMenuBar(QMenuBar *menuBar) {
+        Q_D(WindowBar);
+        auto org = takeMenuBar();
+        if (org)
+            org->deleteLater();
+        if (!menuBar)
+            return;
+        d->setWidgetAt(WindowBarPrivate::MenuWidget, menuBar);
+        menuBar->setSizePolicy(QSizePolicy::Maximum, QSizePolicy::Minimum);
+    }
+
+    void WindowBar::setTitleLabel(QLabel *label) {
+        Q_D(WindowBar);
+        auto org = takeTitleLabel();
+        if (org)
+            org->deleteLater();
+        if (!label)
+            return;
+        d->setWidgetAt(WindowBarPrivate::TitleLabel, label);
+        if (d->autoTitle && d->w)
+            label->setText(d->w->windowTitle());
+        label->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Minimum);
+    }
+
+    void WindowBar::setIconButton(QAbstractButton *btn) {
+        Q_D(WindowBar);
+        auto org = takeIconButton();
+        if (org)
+            org->deleteLater();
+        if (!btn)
+            return;
+        d->setWidgetAt(WindowBarPrivate::IconButton, btn);
+        if (d->autoIcon && d->w)
+            btn->setIcon(d->w->windowIcon());
+        btn->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Preferred);
+    }
+
+    void WindowBar::setBackButton(QAbstractButton *btn) {
+        Q_D(WindowBar);
+        auto org = takeBackButton();
+        if (org)
+            org->deleteLater();
+        if (!btn)
+            return;
+        d->setWidgetAt(WindowBarPrivate::BackButton, btn);
+        btn->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Preferred);
+    }
+
+    void WindowBar::setHomeButton(QAbstractButton *btn) {
+        Q_D(WindowBar);
+        auto org = takeHomeButton();
+        if (org)
+            org->deleteLater();
+        if (!btn)
+            return;
+        d->setWidgetAt(WindowBarPrivate::HomeButton, btn);
+        btn->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Preferred);
+    }
+
+    void WindowBar::setFavButton(QAbstractButton *btn) {
+        Q_D(WindowBar);
+        auto org = takeFavButton();
+        if (org)
+            org->deleteLater();
+        if (!btn)
+            return;
+        d->setWidgetAt(WindowBarPrivate::FavButton, btn);
+        btn->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Preferred);
+    }
+
+    void WindowBar::setCenterWidget(QWidget *widget) {
+        Q_D(WindowBar);
+        auto org = takeCenterWidget();
+        if (org)
+            org->deleteLater();
+        if (!widget)
+            return;
+        d->setWidgetAt(WindowBarPrivate::CenterWidget, widget);
+        widget->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Preferred);
+    }
+
+    void WindowBar::setPinButton(QAbstractButton *btn) {
+        Q_D(WindowBar);
+        auto org = takePinButton();
+        if (org)
+            org->deleteLater();
+        if (!btn)
+            return;
+        d->setWidgetAt(WindowBarPrivate::PinButton, btn);
+        connect(btn, &QAbstractButton::clicked, this, &WindowBar::pinRequested);
+    }
+
+    void WindowBar::setMinButton(QAbstractButton *btn) {
+        Q_D(WindowBar);
+        auto org = takeMinButton();
+        if (org)
+            org->deleteLater();
+        if (!btn)
+            return;
+        d->setWidgetAt(WindowBarPrivate::MinimizeButton, btn);
+        connect(btn, &QAbstractButton::clicked, this, &WindowBar::minimizeRequested);
+    }
+
+    void WindowBar::setMaxButton(QAbstractButton *btn) {
+        Q_D(WindowBar);
+        auto org = takeMaxButton();
+        if (org)
+            org->deleteLater();
+        if (!btn)
+            return;
+        d->setWidgetAt(WindowBarPrivate::MaximizeButton, btn);
+        connect(btn, &QAbstractButton::clicked, this, &WindowBar::maximizeRequested);
+    }
+
+    void WindowBar::setCloseButton(QAbstractButton *btn) {
+        Q_D(WindowBar);
+        auto org = takeCloseButton();
+        if (org)
+            org->deleteLater();
+        if (!btn)
+            return;
+        d->setWidgetAt(WindowBarPrivate::CloseButton, btn);
+        connect(btn, &QAbstractButton::clicked, this, &WindowBar::closeRequested);
+    }
+
+    QMenuBar *WindowBar::takeMenuBar() {
+        Q_D(WindowBar);
+        return static_cast<QMenuBar *>(d->takeWidgetAt(WindowBarPrivate::MenuWidget));
+    }
+
+    QLabel *WindowBar::takeTitleLabel() {
+        Q_D(WindowBar);
+        return static_cast<QLabel *>(d->takeWidgetAt(WindowBarPrivate::TitleLabel));
+    }
+
+    QAbstractButton *WindowBar::takeIconButton() {
+        Q_D(WindowBar);
+        return static_cast<QAbstractButton *>(d->takeWidgetAt(WindowBarPrivate::IconButton));
+    }
+
+    QAbstractButton *WindowBar::takeBackButton() {
+        Q_D(WindowBar);
+        return static_cast<QAbstractButton *>(d->takeWidgetAt(WindowBarPrivate::BackButton));
+    }
+
+    QAbstractButton *WindowBar::takeHomeButton() {
+        Q_D(WindowBar);
+        return static_cast<QAbstractButton *>(d->takeWidgetAt(WindowBarPrivate::HomeButton));
+    }
+
+    QAbstractButton *WindowBar::takeFavButton() {
+        Q_D(WindowBar);
+        return static_cast<QAbstractButton *>(d->takeWidgetAt(WindowBarPrivate::FavButton));
+    }
+
+    QWidget *WindowBar::takeCenterWidget() {
+        Q_D(WindowBar);
+        return d->takeWidgetAt(WindowBarPrivate::CenterWidget);
+    }
+
+    QAbstractButton *WindowBar::takePinButton() {
+        Q_D(WindowBar);
+        auto btn = static_cast<QAbstractButton *>(d->takeWidgetAt(WindowBarPrivate::PinButton));
+        if (!btn) {
+            return nullptr;
+        }
+        disconnect(btn, &QAbstractButton::clicked, this, &WindowBar::pinRequested);
+        return btn;
+    }
+
+    QAbstractButton *WindowBar::takeMinButton() {
+        Q_D(WindowBar);
+        auto btn = static_cast<QAbstractButton *>(d->takeWidgetAt(WindowBarPrivate::MinimizeButton));
+        if (!btn) {
+            return nullptr;
+        }
+        disconnect(btn, &QAbstractButton::clicked, this, &WindowBar::minimizeRequested);
+        return btn;
+    }
+
+    QAbstractButton *WindowBar::takeMaxButton() {
+        Q_D(WindowBar);
+        auto btn = static_cast<QAbstractButton *>(d->takeWidgetAt(WindowBarPrivate::MaximizeButton));
+        if (!btn) {
+            return nullptr;
+        }
+        disconnect(btn, &QAbstractButton::clicked, this, &WindowBar::maximizeRequested);
+        return btn;
+    }
+
+    QAbstractButton *WindowBar::takeCloseButton() {
+        Q_D(WindowBar);
+        auto btn = static_cast<QAbstractButton *>(d->takeWidgetAt(WindowBarPrivate::CloseButton));
+        if (!btn) {
+            return nullptr;
+        }
+        disconnect(btn, &QAbstractButton::clicked, this, &WindowBar::closeRequested);
+        return btn;
+    }
+
+    QWidget *WindowBar::hostWidget() const {
+        Q_D(const WindowBar);
+        return d->w;
+    }
+
+    void WindowBar::setHostWidget(QWidget *w) {
+        Q_D(WindowBar);
+
+        QWidget *org = d->w;
+        if (org) {
+            org->removeEventFilter(this);
+        }
+        d_ptr->w = w;
+        if (w) {
+            w->installEventFilter(this);
+        }
+    }
+
+    bool WindowBar::titleFollowWindow() const {
+        Q_D(const WindowBar);
+        return d->autoTitle;
+    }
+
+    void WindowBar::setTitleFollowWindow(bool value) {
+        Q_D(WindowBar);
+        d->autoTitle = value;
+    }
+
+    bool WindowBar::iconFollowWindow() const {
+        Q_D(const WindowBar);
+        return d->autoIcon;
+    }
+
+    void WindowBar::setIconFollowWindow(bool value) {
+        Q_D(WindowBar);
+        d->autoIcon = value;
+    }
+
+    bool WindowBar::eventFilter(QObject *obj, QEvent *event) {
+        Q_D(WindowBar);
+        auto w = d->w;
+        if (obj == w) {
+            QAbstractButton *iconBtn = iconButton();
+            QLabel *label = titleLabel();
+            QAbstractButton *maxBtn = maxButton();
+            switch (event->type()) {
+                case QEvent::WindowIconChange: {
+                    if (d_ptr->autoIcon && iconBtn) {
+                        iconBtn->setIcon(w->windowIcon());
+                        iconChanged(w->windowIcon());
+                    }
+                    break;
+                }
+                case QEvent::WindowTitleChange: {
+                    if (d_ptr->autoTitle && label) {
+                        label->setText(w->windowTitle());
+                        titleChanged(w->windowTitle());
+                    }
+                    break;
+                }
+                case QEvent::WindowStateChange: {
+                    if (maxBtn) {
+                        maxBtn->setChecked(w->isMaximized());
+                    }
+                    break;
+                }
+                default:
+                    break;
+            }
+        }
+        return QWidget::eventFilter(obj, event);
+    }
+
+    void WindowBar::titleChanged(const QString &text) {
+        Q_UNUSED(text)
+    }
+
+    void WindowBar::iconChanged(const QIcon &icon){Q_UNUSED(icon)}
+
+    WindowBar::WindowBar(WindowBarPrivate &d, QWidget *parent)
+        : QFrame(parent), d_ptr(&d) {
+        d.q_ptr = this;
+
+        d.init();
+    }
+
+}

libs/qwindowkit/examples/shared/widgetframe/windowbar.h

@@ -0,0 +1,91 @@
+// Copyright (C) 2023-2024 Stdware Collections (https://www.github.com/stdware)
+// Copyright (C) 2021-2023 wangwenx190 (Yuhang Zhao)
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef WINDOWBAR_H
+#define WINDOWBAR_H
+
+#include <QFrame>
+#include <QAbstractButton>
+#include <QMenuBar>
+#include <QLabel>
+#include <QWidget>
+
+namespace QWK {
+
+    class WindowBarPrivate;
+
+    class WindowBar : public QFrame {
+        Q_OBJECT
+        Q_DECLARE_PRIVATE(WindowBar)
+    public:
+        explicit WindowBar(QWidget *parent = nullptr);
+        ~WindowBar();
+
+    public:
+        QMenuBar *menuBar() const;
+        QLabel *titleLabel() const;
+        QAbstractButton *iconButton() const;
+        QAbstractButton *backButton() const;
+        QAbstractButton *homeButton() const;
+        QAbstractButton *favButton() const;
+        QWidget *centerWidget() const;
+        QAbstractButton *pinButton() const;
+        QAbstractButton *minButton() const;
+        QAbstractButton *maxButton() const;
+        QAbstractButton *closeButton() const;
+
+        void setMenuBar(QMenuBar *menuBar);
+        void setTitleLabel(QLabel *label);
+        void setIconButton(QAbstractButton *btn);
+        void setBackButton(QAbstractButton *btn);
+        void setHomeButton(QAbstractButton *btn);
+        void setFavButton(QAbstractButton *btn);
+        void setCenterWidget(QWidget *widget);
+        void setPinButton(QAbstractButton *btn);
+        void setMinButton(QAbstractButton *btn);
+        void setMaxButton(QAbstractButton *btn);
+        void setCloseButton(QAbstractButton *btn);
+
+        QMenuBar *takeMenuBar();
+        QLabel *takeTitleLabel();
+        QAbstractButton *takeIconButton();
+        QAbstractButton *takeBackButton();
+        QAbstractButton *takeHomeButton();
+        QAbstractButton *takeFavButton();
+        QWidget *takeCenterWidget();
+        QAbstractButton *takePinButton();
+        QAbstractButton *takeMinButton();
+        QAbstractButton *takeMaxButton();
+        QAbstractButton *takeCloseButton();
+
+        QWidget *hostWidget() const;
+        void setHostWidget(QWidget *w);
+
+        bool titleFollowWindow() const;
+        void setTitleFollowWindow(bool value);
+
+        bool iconFollowWindow() const;
+        void setIconFollowWindow(bool value);
+
+    Q_SIGNALS:
+        void pinRequested(bool pin = false);
+        void minimizeRequested();
+        void maximizeRequested(bool max = false);
+        void closeRequested();
+
+    protected:
+        bool eventFilter(QObject *obj, QEvent *event) override;
+
+        virtual void titleChanged(const QString &text);
+        virtual void iconChanged(const QIcon &icon);
+
+    protected:
+        WindowBar(WindowBarPrivate &d, QWidget *parent = nullptr);
+
+        QScopedPointer<WindowBarPrivate> d_ptr;
+    };
+
+}
+
+#endif // WINDOWBAR_H

libs/qwindowkit/examples/shared/widgetframe/windowbar_p.h

@@ -0,0 +1,62 @@
+// Copyright (C) 2023-2024 Stdware Collections (https://www.github.com/stdware)
+// Copyright (C) 2021-2023 wangwenx190 (Yuhang Zhao)
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef WINDOWBARPRIVATE_H
+#define WINDOWBARPRIVATE_H
+
+#include <QBoxLayout>
+
+#include "windowbar.h"
+
+namespace QWK {
+
+    class WindowBarPrivate {
+        Q_DECLARE_PUBLIC(WindowBar)
+    public:
+        WindowBarPrivate();
+        virtual ~WindowBarPrivate();
+
+        void init();
+
+        WindowBar *q_ptr;
+
+        QWidget *w;
+        bool autoTitle;
+        bool autoIcon;
+
+        enum WindowBarItem {
+            IconButton,
+            MenuWidget,
+            TitleLabel,
+            BackButton,
+            HomeButton,
+            FavButton,
+            CenterWidget,
+            PinButton,
+            MinimizeButton,
+            MaximizeButton,
+            CloseButton,
+        };
+
+        QHBoxLayout *layout;
+
+        inline QWidget *widgetAt(int index) const {
+            return layout->itemAt(index)->widget();
+        }
+
+        void setWidgetAt(int index, QWidget *widget);
+
+        QWidget *takeWidgetAt(int index);
+
+        inline void insertDefaultSpace(int index) {
+            layout->insertSpacerItem(index, new QSpacerItem(0, 0));
+        }
+
+    private:
+        Q_DISABLE_COPY(WindowBarPrivate)
+    };
+
+}
+
+#endif // WINDOWBARPRIVATE_H

libs/qwindowkit/examples/shared/widgetframe/windowbutton.cpp

@@ -0,0 +1,94 @@
+// 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 "windowbutton.h"
+#include "windowbutton_p.h"
+
+#include <QtCore/QDebug>
+#include <QtGui/QtEvents>
+
+namespace QWK {
+
+    WindowButtonPrivate::WindowButtonPrivate() = default;
+
+    WindowButtonPrivate::~WindowButtonPrivate() = default;
+
+    void WindowButtonPrivate::init() {
+    }
+
+    void WindowButtonPrivate::reloadIcon() {
+        Q_Q(WindowButton);
+
+        if (!q->isEnabled() && !iconDisabled.isNull()) {
+            q->setIcon(iconDisabled);
+            return;
+        }
+
+        if (q->isChecked() && !iconChecked.isNull()) {
+            q->setIcon(iconChecked);
+            return;
+        }
+
+        if (!iconNormal.isNull()) {
+            q->setIcon(iconNormal);
+        }
+    }
+
+    WindowButton::WindowButton(QWidget *parent) : WindowButton(*new WindowButtonPrivate(), parent) {
+    }
+
+    WindowButton::~WindowButton() = default;
+
+    QIcon WindowButton::iconNormal() const {
+        Q_D(const WindowButton);
+        return d->iconNormal;
+    }
+
+    void WindowButton::setIconNormal(const QIcon &icon) {
+        Q_D(WindowButton);
+        d->iconNormal = icon;
+        d->reloadIcon();
+    }
+
+    QIcon WindowButton::iconChecked() const {
+        Q_D(const WindowButton);
+        return d->iconChecked;
+    }
+
+    void WindowButton::setIconChecked(const QIcon &icon) {
+        Q_D(WindowButton);
+        d->iconChecked = icon;
+        d->reloadIcon();
+    }
+
+    QIcon WindowButton::iconDisabled() const {
+        Q_D(const WindowButton);
+        return d->iconDisabled;
+    }
+
+    void WindowButton::setIconDisabled(const QIcon &icon) {
+        Q_D(WindowButton);
+        d->iconDisabled = icon;
+        d->reloadIcon();
+    }
+
+    void WindowButton::checkStateSet() {
+        Q_D(WindowButton);
+        d->reloadIcon();
+    }
+
+    void WindowButton::mouseDoubleClickEvent(QMouseEvent *event) {
+        if (event->button() == Qt::LeftButton) {
+            Q_EMIT doubleClicked();
+        }
+    }
+
+    WindowButton::WindowButton(WindowButtonPrivate &d, QWidget *parent)
+        : QPushButton(parent), d_ptr(&d) {
+        d.q_ptr = this;
+
+        d.init();
+    }
+
+}

libs/qwindowkit/examples/shared/widgetframe/windowbutton.h

@@ -0,0 +1,50 @@
+// Copyright (C) 2023-2024 Stdware Collections (https://www.github.com/stdware)
+// Copyright (C) 2021-2023 wangwenx190 (Yuhang Zhao)
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef WINDOWBUTTON_H
+#define WINDOWBUTTON_H
+
+#include <QtWidgets/QPushButton>
+
+namespace QWK {
+
+    class WindowButtonPrivate;
+
+    class WindowButton : public QPushButton {
+        Q_OBJECT
+        Q_DECLARE_PRIVATE(WindowButton)
+        Q_PROPERTY(QIcon iconNormal READ iconNormal WRITE setIconNormal FINAL)
+        Q_PROPERTY(QIcon iconChecked READ iconChecked WRITE setIconChecked FINAL)
+        Q_PROPERTY(QIcon iconDisabled READ iconDisabled WRITE setIconDisabled FINAL)
+    public:
+        explicit WindowButton(QWidget *parent = nullptr);
+        ~WindowButton();
+
+    public:
+        QIcon iconNormal() const;
+        void setIconNormal(const QIcon &icon);
+
+        QIcon iconChecked() const;
+        void setIconChecked(const QIcon &icon);
+
+        QIcon iconDisabled() const;
+        void setIconDisabled(const QIcon &icon);
+
+    Q_SIGNALS:
+        void doubleClicked();
+
+    protected:
+        void checkStateSet() override;
+
+        void mouseDoubleClickEvent(QMouseEvent *event) override;
+
+    protected:
+        WindowButton(WindowButtonPrivate &d, QWidget *parent = nullptr);
+
+        QScopedPointer<WindowButtonPrivate> d_ptr;
+    };
+
+}
+
+#endif // WINDOWBUTTON_H

libs/qwindowkit/examples/shared/widgetframe/windowbutton_p.h

@@ -0,0 +1,31 @@
+// Copyright (C) 2023-2024 Stdware Collections (https://www.github.com/stdware)
+// Copyright (C) 2021-2023 wangwenx190 (Yuhang Zhao)
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef WINDOWBUTTONPRIVATE_H
+#define WINDOWBUTTONPRIVATE_H
+
+#include "windowbutton.h"
+
+namespace QWK {
+
+    class WindowButtonPrivate {
+        Q_DECLARE_PUBLIC(WindowButton)
+    public:
+        WindowButtonPrivate();
+        virtual ~WindowButtonPrivate();
+
+        void init();
+
+        WindowButton *q_ptr;
+
+        QIcon iconNormal;
+        QIcon iconChecked;
+        QIcon iconDisabled;
+
+        void reloadIcon();
+    };
+
+}
+
+#endif // WINDOWBUTTONPRIVATE_H