FramelessHelper使用指南

洪赫逊

于 2024-08-08 07:52:37 发布

阅读量632

点赞数 17

本文链接：https://blog.csdn.net/gitblog_00613/article/details/141011722

版权

FramelessHelper使用指南

FramelessHelperQt based frameless window class, full features.项目地址:https://gitcode.com/gh_mirrors/fra/FramelessHelper

项目介绍

FramelessHelper 是一个基于Qt的跨平台窗口定制框架，适用于Qt Widgets和Qt Quick应用程序。它允许开发者创建无边框的窗口，并提供了丰富的功能来处理窗口的拖动、缩放等交互行为，同时支持Windows、Linux和macOS系统。此框架大大简化了在不同操作系统上实现统一美观的无边框UI的设计与开发过程。

项目快速启动

步骤一：获取FramelessHelper库

首先，通过GitHub克隆FramelessHelper项目仓库到本地：

git clone https://github.com/qtdevs/FramelessHelper.git

步骤二：配置CMake

确保你的CMake能够找到FramelessHelper库。可以通过以下命令指定CMAKE_PREFIX_PATH或者FramelessHelper_DIR：

cmake -DCMAKE_PREFIX_PATH=/path/to/framelesshelper/installation ..
# 或者，如果你知道具体路径：
cmake -DFramelessHelper_DIR=/path/to/framelesshelper/lib64/cmake/FramelessHelper ..

如果你的项目也是用CMake管理的，可以将FramelessHelper作为子模块集成进来。

步骤三：在Qt项目中集成FramelessHelper

对于Qt Widgets应用，添加以下到你的CMakeLists.txt中：

find_package(FramelessHelper REQUIRED COMPONENTS Widgets)
...
target_link_libraries(your_target FramelessHelper::Widgets)

随后，在代码中使用FramelessHelper的功能，例如设置无边框：

#include <FramelessHelper/Widgets.h>

// 在你的窗口类初始化中...
FramelessWidgetsHelper::setAsFrameless(window);

对于Qt Quick应用，则在QML中使用：

import FramelessHelper 1.0

Window {
    ...
    FramelessHelper.Window {
        id: mainWindow
    }
}

应用案例和最佳实践

在设计无边框窗口的应用时，利用FramelessHelper提供的API来实现标题栏自定义和窗口边缘拖拽是关键。确保对用户交互做出响应，比如在用户点击非标题栏区域时启动移动窗口逻辑，并保持窗口控件的可见性正确设置以不影响操作。

// 对于Qt Widgets应用
void YourWidget::setupUi() {
    auto titleBar = new QWidget(this);
    // 设置标题栏相关组件后，
    FramelessWidgetsHelper::get(this)->setTitleBarWidget(titleBar);
}

// 设置特定控件可被点击移动窗口
FramelessWidgetsHelper::get(this)->setHitTestVisible(someControl);