文档开发者中心
我的
|

HarmonyOS 6

HarmonyOS 5

HarmonyOS PC上基于Qt框架的屏幕取色功能示例

场景介绍

HarmonyOS PC上基于Qt框架的屏幕取色是Qt项目高频使用场景之一,例如使用拾色器获取界面或图像中的特定颜色。 本示例使用颜色选择对话框QColorDialog实现从调色板中选取颜色。

效果预览

  • 运行项目后点击“选择/吸取颜色”按钮,可以选择调色盘中的颜色,也可以吸取屏幕中的颜色,确认选择的颜色后点击“OK”按钮:

&&KNOWLEDGEIMGURLPREFIX&&/20251229/0b3ce7f0-784c-48e8-b3b5-cf9d8d5de2e7.png

  • 主窗口中显示选取后的颜色:

&&KNOWLEDGEIMGURLPREFIX&&/20251229/63f6f867-84e6-47e2-a35a-69751509e01a.png

实现思路

开源版Qt项目和商业版Qt项目中main.cpp代码的实现思路相同,具体内容如下:

  • 在src/main/cpp/main.cpp文件中,使用静态函数getColor选择需要选取的RGB颜色,并使用ShowAlphaChannel选取具有透明度的颜色。部分代码如下:
    收起
    自动换行
    深色代码主题
    复制
    QColor selectedColor = QColorDialog::getColor(
       Qt::white, 
       this, 
       "选择颜色", 
       QColorDialog::ShowAlphaChannel
    );
    
  • 在src/main/cpp/main.cpp文件中,alphaF返回透明度的浮点值,而alpha返回透明度的整数值(0~255)。自定义的applyColor方法实现将选取的颜色应用到控件并显示该颜色的RGBA数值,代码如下:
    收起
    自动换行
    深色代码主题
    复制
     void applyColor(const QColor &color) 
     {
         // 获取RGBA值
         int r = color.red();
         int g = color.green();
         int b = color.blue();
         double alphaF = color.alphaF();  
         int alpha = color.alpha();      
     
         QString colorStyle = QString("QLabel { background-color: rgba(%1, %2, %3, %4); border: 1px solid #cccccc; }")
                              .arg(r)
                              .arg(g)
                              .arg(b)
                              .arg(alphaF);
         colorLabel->setStyleSheet(colorStyle);
    
         
         QString rgbaText = QString("当前颜色RGBA值:R:%1  G:%2  B:%3  A:%4")
                            .arg(r)
                            .arg(g)
                            .arg(b)
                            .arg(alpha);
         rgbaInfoLabel->setText(rgbaText);
     }
    

说明

一、在开源版Qt中使用颜色选择对话框QColorDialog选取颜色功能。 使用该示例需要完成下面两个操作:

  1. 将libs\arm64-v8a下的libplugins_platforms_qopenharmony.so文件替换为本地Qt安装路径\plugins\platforms目录下的libplugins_platforms_qopenharmony.so。

  2. 将开源版Qt安装路径配置到QT_PREFIX中,可以选择下面两个方案中的一个:

    • 修改entry\src\main\cpp\qtModule\CMakeLists.txt中的set(QT_PREFIX "D:\\arkTSProject\\QtSdkOpen\\ohos17_arm64-v8a_release")为编译出的Qt产物目录:
    收起
    自动换行
    深色代码主题
    复制
    # 检查环境变量是否存在
    if(DEFINED ENV{WORKSPACE})
       set(QT_PREFIX $ENV{WORKSPACE}/code/SDK/Qt/QtOpenSDK)
       message(STATUS "get QT_PREFIX PATH: ${QT_PREFIX}")
    else()
       set(QT_PREFIX "D:\\arkTSProject\\QtSdkOpen\\ohos17_arm64-v8a_release")
       message(STATUS "WORKSPACE not defined, using default path: ${QT_PREFIX}")
    endif()
    
    • 或者删除entry\src\main\cpp\qtModule\CMakeLists.txt中的QT_PREFIX定义,并在entry\build-profile.json5中设置QT_PREFIX:
    收起
    自动换行
    深色代码主题
    复制
    "buildOption": {
       "externalNativeOptions": {
          "path": "./src/main/cpp/CMakeLists.txt",
          "arguments": "-DQT_PREFIX=D:\\arkTSProject\\QtSdkOpen\\ohos17_arm64-v8a_release",
          "cppFlags": "",
          "abiFilters": ["arm64-v8a"]
       }
    },
    

二、在商业版Qt中使用颜色选择对话框QColorDialog选取颜色功能。 使用该示例需要完成下面两个操作:

  1. 将libs\arm64-v8a下的libqohos.so文件替换为本地Qt安装路径\plugins\platforms目录下的libqohos.so。

  2. 将商业版Qt安装路径配置到QT_PREFIX中,可以选择下面两个方案中的一个:

    • 修改entry\src\main\cpp\qtModule\CMakeLists.txt中的set(QT_PREFIX "D:\\qtBusiness\\installDir")为编译出的Qt产物目录:
    收起
    自动换行
    深色代码主题
    复制
    # 检查环境变量是否存在
    if(DEFINED ENV{WORKSPACE})
       set(QT_PREFIX $ENV{WORKSPACE}/code/SDK/Qt/QtOpenSDK)
       message(STATUS "get QT_PREFIX PATH: ${QT_PREFIX}")
    else()
       set(QT_PREFIX "D:\\qtBusiness\\installDir")
       message(STATUS "WORKSPACE not defined, using default path: ${QT_PREFIX}")
    endif()
    
    • 或者删除entry\src\main\cpp\qtModule\CMakeLists.txt中的QT_PREFIX定义,并在entry\build-profile.json5中设置QT_PREFIX:
    收起
    自动换行
    深色代码主题
    复制
    "buildOption": {
       "externalNativeOptions": {
          "path": "./src/main/cpp/CMakeLists.txt",
          "arguments": "-DQT_PREFIX=D:\\qtBusiness\\installDir",
          "cppFlags": "",
          "abiFilters": ["arm64-v8a"]
       }
    },
    

约束与限制

  • 本示例支持API Version 20 Release及以上版本。
  • 本示例支持HarmonyOS 6.0.0 Release SDK及以上版本。
  • 本示例需要使用DevEco Studio 6.0.0 Release及以上版本进行编译运行。

工程目录

一、开源版Qt工程的qtOpen目录。

收起
自动换行
深色代码主题
复制
├─entry
│  ├─libs/arm64-v8a
│  │  └─libplugins_platforms_qopenharmony.so    // Qt安装目录'plugins\platforms'HarmonyOS平台插件so
│  └─src
│      ├─main
│      │  ├─cpp
│      │  │  ├─main.cpp                         // Qt项目主入口
│      │  │  └─CMakeLists.txt                   // Qt项目CMakeList文件
│      │  ├─ets
│      │  │  ├─abilitystage
│      │  │  │  └─MyAbilityStage.ets
│      │  │  ├─entryability
│      │  │  │  └─EntryAbility.ets              // 应用入口
│      │  │  └─pages
│      │  │     └─Index.ets                     // 主页面实现
│      │  ├─resources                           // 应用资源目录
│      │  └─module.json5                        // 模块级核心配置文件
│      ├─build-profile.json5                    // 工程结构/构建/定制化配置信息
│      └─oh-package.json5                       // 描述全局配置
└─hvigor                                        // 构建环境配置

二、商业版Qt工程的qtBusiness目录。

收起
自动换行
深色代码主题
复制
├─entry
│  ├─libs/arm64-v8a
│  │  └─libqohos.so                             // 商业版Qt产物so
│  └─src
│      ├─main
│      │  ├─cpp
│      │  │  ├─main.cpp                         // Qt的主入口
│      │  │  └─CMakeLists.txt                   // Qt项目CMakeList文件
│      │  ├─ets                                 // 与商业版Qt模板工程保持一致
│      │  │  ├─common
│      │  │  │  └─QtAppConstants.ets
│      │  │  ├─pages
│      │  │  │  ├─FloatWindowNativeNode.ets
│      │  │  │  ├─MainWindowNativeNode.ets
│      │  │  │  ├─SubWindowNativeNode.ets
│      │  │  │  └─UiExtensionNativeNode.ets
│      │  │  ├─process
│      │  │  │  └─QChildProcess.ets
│      │  │  ├─qability
│      │  │  │  ├─LocalStorageTsModule.ets
│      │  │  │  ├─OhosExportModules.ets
│      │  │  │  ├─QAbility.ets
│      │  │  │  ├─QEmbeddedComponentCreator.ets
│      │  │  │  ├─QEmbeddedComponentCreatorTsModule.ets
│      │  │  │  ├─QEmbeddedUiExtensionAbility.ets
│      │  │  │  └─QtUtils.ets
│      │  │  └─qabilitystage 
│      │  │     └─QAbilityStage.ets
│      │  ├─qt                                             // 与商业版Qt模板工程保持一致
│      │  │  ├─libqohos.d.ts
│      │  │  └─oh-package.json5
│      │  ├─resources                                      // 应用资源目录
│      │  └─module.json5                                   // 模块级核心配置文件
│      ├─build-profile.json5                               // 工程结构/构建/定制化配置信息
│      └─oh-package.json5                                  // 描述全局配置
└─hvigor                                                   // 构建环境配置

模块依赖

开源版Qt。 商业版Qt项目模板工程。

参考文档

QColorDialog alphaF alpha

代码示例

详细内容见HarmonyOS PC上基于Qt框架的屏幕取色功能示例

点赞
收藏
回复
分享
举报
浏览92 编辑于2026-02-26 08:39广东
全部评论
最多点赞
最新发布
最早发布
暂无评论
暂无评论
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

目录 收起
场景介绍
效果预览
实现思路
说明
约束与限制
工程目录
模块依赖
参考文档
代码示例
了解社区公约,与您携手共创和谐专业的开发者社区。