Qt窗口在双屏上不显示的问题及解决方法
有个比较古老的应用是用Qt4写的。在维护的过程中,将Qt4升级为Qt5.13.2。一开始没有发现什么问题,就发布了。发布后,用户反馈在双屏环境中应用不能启动(实际上是窗口不显示)。经过一番折腾,总算是找到了原因。当然,也就找到了解决方法。
现象
在双屏环境中,启动应用后,看不到应用程序窗口,不能登录操作,只能通过任务栏关闭应用程序。将双屏切换成单屏模式,应用程序工作正常。
推测:应用程序正常运行,只是看不到窗口而已。那么,为什么会看不到窗口呢?
问题
我们先来看一段测试代码及其运行结果。也许,后面的都不用看,你已经明白是怎么回事儿了。
QDesktopWidget *dw = QApplication::desktop();
qDebug() << dw->availableGeometry();
qDebug() << dw->width() << dw->height();
QScreen *screen = QApplication::primaryScreen();
QRect rect = screen->availableGeometry();
qDebug() << rect;
qDebug() << rect.width() << rect.height();
运行结果
QRect(0,0 1920x1030)
5760 2160
QRect(0,0 1920x1030)
1920 1030
看出问题来了吧!QApplication::desktop()在Qt5及以后的版本中已经废弃了。保留在这里只是为了让旧代码能够工作。新代码中不推荐使用desktop(),取而代之的是QScreen。具体使用细节,请参阅Qt的官方文档。
原代码中有个让窗口居中的操作。按照desktop()返回的结果计算,屏幕的中点在(5760/2=2880, 2160/2=1080)。这个点显然已经跑到屏幕外面了(2880>1920, 1080>1030)。窗口自然也就看不到了。
解决方法
问题找到了,解决问题就很容易了。全局搜索desktop(),用QApplication::primaryScreen()做替换。替换时要注意,前者返回的是QDesktopWidget指针,后者返回的是QScreen指针。代码要借助于availableGeometry()做些简单的调整。
这个解决方法其实并不完美,只是暂时解决了窗口不显示的问题。在两个屏幕之间拖来拖去的时候,窗口的内容可能会发生变形。这是因为应用程序并没有响应屏幕切换事件,并根据屏幕的切换将内容做调整。所以,完美的解决方案应该是响应QWindow对象的screenChanged()信号,并对可视内容做出相应的调整。在此不再详述,请读者自行研究。
结论
Qt5之后,不要再使用QApplication::desktop()。 重要的事情,不用说三遍也应该记住。