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

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

所有评论(0)