项目源码 · README

开源鸿蒙跨平台开发者社区 · Qt 鸿蒙电脑开源社区

前言

把外接屏摆到主屏左边,窗口坐标出现负数完全正常。只有把左边那块屏拔掉,存下来的位置才可能落到看不见的地方。Qt 工程得回答两个问题:原来的屏还在吗,选定了当前屏以后,窗口四条边放得下吗?当前证据来自单屏鸿蒙电脑模拟器,双屏拔插按后面的步骤另测。

「屏幕接力」用 Qt Widgets 写成。它把当前屏幕及其可用几何面积列出来,提供手动回主屏入口。启动恢复、屏幕移除和手动恢复复用同一个窗口定位函数。这样可以先在一块屏幕上验证定位函数,再带到有两块屏幕的鸿蒙电脑上复测热拔插。

先算一次窗口边界

假设窗口上一次留在主屏左边,左上角是 (-720, 260),内容宽 840、高 550。当前主屏可用区从 (0, 0) 开始,宽 3120、高 1955。恢复时,宽高都能放下,只要把横坐标拉回 0,纵坐标维持 260。屏幕还接着时,左边那块屏可能本来就允许负坐标,因此这道题要先选好目标屏再算。这里的负坐标是说明算式的输入,后面的矩形与画面才是模拟器实测结果。

单屏复测

操作环境实测
安装 HAP 后启动鸿蒙电脑模拟器Qt 宿主打开「屏幕接力」窗口,识别 1 块屏幕
点击「回到主屏」同一模拟器状态更新,hilog 写出 1140,703 840×550
缩窄桌面窗口同一模拟器屏幕信息和回主屏按钮仍可见
从外接屏上拔掉显示器鸿蒙电脑双屏需要 MateBook 14 和外接屏实际复测

鸿蒙电脑模拟器全屏:点击回到主屏后查看窗口与程序坞

鸿蒙电脑模拟器全屏:点击回到主屏后查看窗口与程序坞 · 查看原件

鸿蒙电脑模拟器全屏:缩窄窗口后仍保留主操作

鸿蒙电脑模拟器全屏:缩窄窗口后仍保留主操作 · 查看原件

鸿蒙电脑模拟器全屏:窗口宽度调整

鸿蒙电脑模拟器全屏:窗口宽度调整 · 查看原件

模拟器演示:单屏窗口回到主屏

鸿蒙电脑模拟器单屏操作 · 查看原件

鸿蒙电脑模拟器单屏操作

项目实测配置
模拟器设备DevEco Emulator 6.1.1.350,鸿蒙电脑 x86_64,单屏 3120×2080
模拟器系统HarmonyOS 6.1.0.125 (SP12DEVC00E47R1P3),API 24
构建DevEco Studio 6.1.1.300,工程目标和最低兼容均为 API 24
框架Qt 5.15.12 鸿蒙移植版,Qt Core、Gui、Widgets

鸿蒙电脑模拟器关于本机

鸿蒙电脑模拟器关于本机 · 查看原件

DevEco Studio 关于

DevEco Studio 关于 · 查看原件

系统桌面分辨率和应用读到的可用区域有区别。截图显示的是 3120×2080,Qt 屏幕列表显示主屏可用区域为 3120×1955。底部 Dock 占的位置留在可用区外,保存下来的窗口如果落到这一区域,恢复时就需要往上收。窗口体积来自 QWidget,桌面额外绘制的窗口装饰也需要在真机上实际检查。

VS Code 工程:接收 Qt 屏幕移除通知并检查是否要回主屏

VS Code 工程:接收 Qt 屏幕移除通知并检查是否要回主屏 · 查看原件

计算仍可见的窗口矩形

保存下次恢复要用的屏幕名称和窗口矩形。启动后遍历当前能看见的屏幕,仍能找到同名屏幕就以它作为目标。找不到时拿当前主屏。选到目标以后才做边界计算。坐标可以为负数,只要它仍在目标屏范围里就有效。应用能否容纳原来的宽高,则由目标区域大小决定。

QRect visibleFrame(const QRect &saved, const QRect &area)
{
    if (area.isEmpty()) return saved;
    const int w = qBound(qMin(340, area.width()), saved.width(), area.width());
    const int h = qBound(qMin(240, area.height()), saved.height(), area.height());
    return QRect(qBound(area.left(), saved.x(), area.right() - w + 1),
                 qBound(area.top(), saved.y(), area.bottom() - h + 1), w, h);
}

这里先处理宽高,再限制左上角。若先把左上角修好,却还用上一块高分辨率屏幕的宽度,窗口右半部分仍可能跑到可用区外。QRect 的 right 和 bottom 都包含了边界像素,因此限制窗口左边界时各加 1,避免尺寸恰好等于可用区时差一个单位。运行日志输出计算得到的 Qt 几何信息,外观和装饰层的位置还要用系统窗口截图对照。

窗口移动的时候,screenChanged 只刷新屏幕列表。screenRemoved 检查被移除的对象是否是窗口当前的屏幕,只有相关时才尝试回主屏。定位排入下一次事件循环,避免在通知回调里立刻读取可能仍在调整的列表。排队只保存矩形和布尔值,避免在延迟回调再解引用已移除的 QScreen。

QObject::connect(&app, &QGuiApplication::screenRemoved, &window, [&](QScreen *removed) {
    const bool affected = window.windowHandle() && window.windowHandle()->screen() == removed;
    const QRect previous = window.geometry();
    QTimer::singleShot(0, &window, [&, affected, previous] {
        if (affected) place(QGuiApplication::primaryScreen(), previous);
        refresh();
    });
});

实际显示位置还受鸿蒙 Qt 平台插件和窗口管理器影响。Qt 信号给的是桌面拓扑变化的信息。程序发出 setScreen 和 setGeometry 后,仍需检查窗口管理器最终将窗口显示在哪里。有些插件会在 screenRemoved 返回后自行迁移窗口,也可能对 setGeometry 做最小尺寸校正。可在双屏测试时同时记录 remove 信号、当前主屏、窗口最终几何,观察搬动是应用策略还是平台默认操作。

拔屏与重启分别验证

把外接屏放到主屏左边,打开程序并将窗口拖到外接屏。拍下桌面全图与两个屏幕的排列。直接拔下外接屏,连续记录窗口是否完整出现、是否还能点按钮、标题栏是否可拖动。然后在双屏条件下退出一次,再保持外接屏断开重新启动,核对应用是否从旧几何恢复到现在的主屏。两种操作分别覆盖进程运行中和应用重启,任一条成功都不代表另一条也通过。

在模拟器中可重复单屏启动、手动回退和宽窄窗检查。调整模拟器分辨率属于同一屏幕的变化,不能据此报告外接屏热拔插成功。

FAQ

主屏左侧的屏幕坐标小于零,是设备报告错了吗? 左侧屏幕有负坐标很正常。要判断窗口是否越界,应拿保存的矩形与目标屏 availableGeometry() 比较。

拖到外接屏后直接断电,会保存位置吗? 本例在 aboutToQuit 保存,正常退出可触发。强制终止或断电没有这个保证。若业务要求实时保存,应在窗口移动或缩放完成后做节流写入,并确保仍能处理保存目标已经消失的情况。

日志显示回主屏了,画面为什么还要看? 日志记录的是代码请求的矩形。要检查平台有没有应用限制,还要看窗口标题栏、主按钮和系统栏的位置。尤其是外接屏缩放比例与主屏不同的时候。

Windows 构建遇到 11201001 怎么定位? 这次重建进入 CompileResource 时,日志报告加载 libimage_transcoder_shared.dll 失败。先核对 SDK 版本和运行库路径。示例未启用图片压缩,可在本次构建设置 CUTOUT_NO_RESOURCE_COMPRESSION=1。构建钩子先读取生成的压缩配置,确定没有压缩规则才移除该项。它只处理工程生成文件,保留 SDK 原样。需要压缩资源的项目应补齐 SDK 运行库。

总结

窗口恢复先查目标屏,再在它的可用区域内收住矩形。单屏鸿蒙电脑模拟器已验证 HAP 启动、主屏入口和窄窗口,双屏热拔插与断开后的恢复留在实际双屏验收项。实现依赖的信号和几何定义可查 Qt QGuiApplication 与 Qt QScreen。

工程代码

主窗口与屏幕事件

entry/src/main/cpp/main.cpp

#include <QApplication>
#include <QGuiApplication>
#include <QLabel>
#include <QListWidget>
#include <QPushButton>
#include <QScreen>
#include <QSettings>
#include <QTimer>
#include <QVBoxLayout>
#include <QWindow>
#include <QWidget>
#include <hilog/log.h>

QRect visibleFrame(const QRect &saved, const QRect &area)
{
    if (area.isEmpty()) return saved;
    const int w = qBound(qMin(340, area.width()), saved.width(), area.width());
    const int h = qBound(qMin(240, area.height()), saved.height(), area.height());
    return QRect(qBound(area.left(), saved.x(), area.right() - w + 1),
                 qBound(area.top(), saved.y(), area.bottom() - h + 1), w, h);
}

int main(int argc, char **argv)
{
    QApplication app(argc, argv);
    QSettings settings(QStringLiteral("OpenHarmonyDemos"), QStringLiteral("ScreenRelay"));
    QWidget window;
    window.setWindowTitle(QStringLiteral("屏幕接力"));
    auto *layout = new QVBoxLayout(&window);
    layout->setContentsMargins(24, 20, 24, 20);
    auto *title = new QLabel(QStringLiteral("窗口还在屏幕里吗?"));
    title->setObjectName(QStringLiteral("title"));
    auto *status = new QLabel;
    status->setWordWrap(true);
    auto *screens = new QListWidget;
    auto *button = new QPushButton(QStringLiteral("回到主屏"));
    layout->addWidget(title);
    layout->addWidget(status);
    layout->addWidget(screens, 1);
    layout->addWidget(button, 0, Qt::AlignLeft);
    window.setStyleSheet(QStringLiteral(R"(
        QWidget { background:#f3f1fa; color:#252336; font-size:21px; }
        QLabel#title { font-size:36px; font-weight:700; }
        QListWidget { border:1px solid #cbc2de; background:#fbf9ff; padding:10px; }
        QPushButton { background:#53417e; color:white; border:0; padding:9px 15px; border-radius:7px; }
        QPushButton:focus { border:2px solid #9b86c6; }
    )"));

    auto refresh = [&] {
        screens->clear();
        const auto available = QGuiApplication::screens();
        for (QScreen *screen : available) {
            const QRect area = screen->availableGeometry();
            screens->addItem(QStringLiteral("%1  %2 × %3  (%4, %5)")
                .arg(screen == QGuiApplication::primaryScreen() ? QStringLiteral("主屏") : QStringLiteral("外接屏"))
                .arg(area.width()).arg(area.height()).arg(area.x()).arg(area.y()));
        }
        status->setText(QStringLiteral("已识别 %1 块屏幕").arg(available.size()));
    };
    auto place = [&](QScreen *target, QRect previous) {
        if (!target) return;
        QWindow *handle = window.windowHandle();
        if (handle && handle->screen() != target) handle->setScreen(target);
        const QRect bounds = visibleFrame(previous, target->availableGeometry());
        window.setGeometry(bounds);
        OH_LOG_Print(LOG_APP, LOG_INFO, 0xD001, "ScreenRelay", "geometry %{public}d,%{public}d %{public}dx%{public}d",
                     bounds.x(), bounds.y(), bounds.width(), bounds.height());
    };
    window.resize(840, 550);
    window.show();
    QScreen *savedScreen = nullptr;
    const auto savedName = settings.value(QStringLiteral("screen")).toString();
    for (auto *screen : QGuiApplication::screens()) {
        if (screen->name() == savedName) savedScreen = screen;
    }
    place(savedScreen ? savedScreen : QGuiApplication::primaryScreen(),
          settings.value(QStringLiteral("frame"), window.geometry()).toRect());
    refresh();
    QObject::connect(button, &QPushButton::clicked, &window, [&] {
        place(QGuiApplication::primaryScreen(), window.geometry());
        refresh();
        status->setText(QStringLiteral("已请求将窗口放回主屏"));
    });
    QObject::connect(&app, &QGuiApplication::screenAdded, &window, [&](QScreen *) { refresh(); });
    QObject::connect(&app, &QGuiApplication::screenRemoved, &window, [&](QScreen *removed) {
        const bool affected = window.windowHandle() && window.windowHandle()->screen() == removed;
        const QRect previous = window.geometry();
        QTimer::singleShot(0, &window, [&, affected, previous] {
            if (affected) place(QGuiApplication::primaryScreen(), previous);
            refresh();
        });
    });
    QObject::connect(window.windowHandle(), &QWindow::screenChanged, &window, [&](QScreen *) { refresh(); });
    QObject::connect(&app, &QCoreApplication::aboutToQuit, &window, [&] {
        const auto *handle = window.windowHandle();
        if (handle && handle->screen()) settings.setValue(QStringLiteral("screen"), handle->screen()->name());
        settings.setValue(QStringLiteral("frame"), window.geometry());
        settings.sync();
    });
    return app.exec();
}

Qt 组件与构建入口

entry/src/main/cpp/CMakeLists.txt

cmake_minimum_required(VERSION 3.16)
project(entry LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
get_filename_component(DEFAULT_QT_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../.tools/ugc-framework-probes/qt-sdk" ABSOLUTE)
set(QT_ROOT "${DEFAULT_QT_ROOT}" CACHE PATH "Qt for OpenHarmony SDK")
list(APPEND CMAKE_PREFIX_PATH "${QT_ROOT}")
list(APPEND CMAKE_FIND_ROOT_PATH "${QT_ROOT}")
find_package(Qt5 REQUIRED COMPONENTS Core Gui Widgets)
add_library(entry SHARED main.cpp)
target_link_libraries(entry PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets hilog_ndk.z)
Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐