バグを直すとき、エラー画面をエディタの横に置いたままコードを書きたいことがあります。自作のスクリーンショットツール SnapTray では、キャプチャした画像を独立したウィンドウに表示しています。この機能で別々に考える必要があるのが、ウィンドウの重なり順と、画像を表示する座標系です。
ウィンドウの寸法には論理サイズを使う
たとえば、幅600・高さ400の領域をデバイスピクセル比(DPR)2の画面でキャプチャすると、画像は1200×800ピクセルになります。ここで setFixedSize(pixmap.size()) と書くと、Qt Widgets は1200×800を論理サイズとして受け取ります。幅も高さも意図した値の2倍です。
Qt 6.2以降では、QPixmap::deviceIndependentSize() で画像の論理サイズを取得できます。次は、キャプチャ済みの画像を受け取る最小例です。GUIスレッドで、適切なDPRが設定された QPixmap を渡します。
#include <QLabel>
#include <QPixmap>
void pinScreenshot(const QPixmap &capture)
{
if (capture.isNull())
return;
auto *pin = new QLabel(nullptr, Qt::FramelessWindowHint
| Qt::WindowStaysOnTopHint);
pin->setAttribute(Qt::WA_DeleteOnClose);
pin->setPixmap(capture);
pin->setFixedSize(capture.deviceIndependentSize().toSize());
pin->show();
}
画像を600×400ピクセルに縮小して作り直す必要はありません。元の画素とDPRを保ったまま、ウィンドウに渡す寸法だけを600×400にします。逆に、取得元がDPRを付けずに画像を返した場合、このメソッドだけでは元の表示倍率を復元できません。まずキャプチャ直後の size() と devicePixelRatio() を確認すると切り分けやすくなります。
「最前面」の確認は別のアプリで行う
Qt::FramelessWindowHint は枠を外し、Qt::WindowStaysOnTopHint は最前面での表示をウィンドウシステムに要求します。表示直後は普通のウィンドウも手前に出るので、その瞬間だけでは判定できません。表示後に別アプリのエディタをクリックし、文字を入力でき、かつ参照画像が見え続けるかを確認します。
SnapTray の実装では、macOSでアプリが非アクティブになったときに参照画像が隠れるため、ピン留め画面のフラグから Qt::Tool を外しています。LinuxのX11向けには追加のウィンドウフラグも指定しています。上の短い例は共通部分を取り出したもので、実際のプラットフォーム別設定は下記のソースで確認できます。
寸法の問題を調べるときは、同じ論理サイズの領域を倍率100%と200%でそれぞれキャプチャします。ピン留め直後のウィンドウ寸法がほぼ同じならサイズ変換は期待どおりです。そこで初めてフォーカスを切り替えると、「大きさが変わる」と「背面に隠れる」を別々に検証できます。



