Qt 5.12无边框ApplicationWindow拖拽问题：无法半隐藏出屏幕

核心原因 #

Qt 默认会对窗口位置做屏幕边界限制，使用startSystemMove()这类系统拖拽方法时，会强制窗口保持在屏幕可视范围内。要实现半隐藏效果，必须绕过这个默认约束，手动处理拖拽时的窗口位置计算。

具体实现方案 #

方案1：纯QML实现（无需C++代码） #

直接在顶部拖拽区域的MouseArea中手动计算窗口位置，替代系统默认的拖拽逻辑：

import QtQuick 2.12
import QtQuick.Controls 2.12

ApplicationWindow {
    id: mainWindow
    flags: Qt.FramelessWindowHint
    visible: true
    width: 800
    height: 600

    Rectangle {
        id: titleBar
        width: parent.width
        height: 50
        color: "#333"

        MouseArea {
            anchors.fill: parent
            // 记录鼠标按下时的相对位置
            property point pressOffset: Qt.point(0, 0)

            onPressed: {
                pressOffset = Qt.point(mouseX, mouseY)
            }

            onMouseMove: {
                if (pressed) {
                    // 直接计算并设置窗口新位置，不做边界限制
                    var newX = mainWindow.x + (mouseX - pressOffset.x)
                    var newY = mainWindow.y + (mouseY - pressOffset.y)
                    mainWindow.setPosition(newX, newY)
                }
            }
        }
    }
}

方案2：C++重写窗口事件（适合复杂场景） #

如果需要更灵活的控制，可以自定义ApplicationWindow子类，重写鼠标事件来处理拖拽：

#include <QApplicationWindow>
#include <QMouseEvent>

class CustomFramelessWindow : public QApplicationWindow
{
    Q_OBJECT
private:
    bool m_isDragging = false;
    QPoint m_dragStartOffset;

protected:
    void mousePressEvent(QMouseEvent *event) override
    {
        // 判断是否点击顶部拖拽区域（这里假设顶部50px为拖拽区）
        if (event->button() == Qt::LeftButton && event->y() < 50) {
            m_isDragging = true;
            // 记录鼠标按下时，全局坐标与窗口左上角的偏移
            m_dragStartOffset = event->globalPos() - frameGeometry().topLeft();
            event->accept();
            return;
        }
        QApplicationWindow::mousePressEvent(event);
    }

    void mouseMoveEvent(QMouseEvent *event) override
    {
        if (m_isDragging) {
            // 直接计算新位置并移动窗口，不做屏幕边界裁剪
            QPoint newPos = event->globalPos() - m_dragStartOffset;
            move(newPos);
            event->accept();
            return;
        }
        QApplicationWindow::mouseMoveEvent(event);
    }

    void mouseReleaseEvent(QMouseEvent *event) override
    {
        m_isDragging = false;
        QApplicationWindow::mouseReleaseEvent(event);
    }
};

方案3：事件过滤器（混合QML与C++场景） #

如果需要在现有QML窗口中注入拖拽逻辑，可以用事件过滤器拦截鼠标事件：

#include <QObject>
#include <QEvent>
#include <QMouseEvent>
#include <QQuickWindow>

class WindowDragFilter : public QObject
{
    Q_OBJECT
private:
    bool m_isDragging = false;
    QPoint m_dragOffset;

protected:
    bool eventFilter(QObject *obj, QEvent *event) override
    {
        QQuickWindow *window = qobject_cast<QQuickWindow*>(obj);
        if (!window) return QObject::eventFilter(obj, event);

        switch (event->type()) {
        case QEvent::MouseButtonPress: {
            QMouseEvent *mouseEvt = static_cast<QMouseEvent*>(event);
            if (mouseEvt->button() == Qt::LeftButton && mouseEvt->y() < 50) {
                m_isDragging = true;
                m_dragOffset = mouseEvt->globalPos() - window->frameGeometry().topLeft();
                return true;
            }
            break;
        }
        case QEvent::MouseMove: {
            if (m_isDragging) {
                QMouseEvent *mouseEvt = static_cast<QMouseEvent*>(event);
                QPoint newPos = mouseEvt->globalPos() - m_dragOffset;
                window->setPosition(newPos);
                return true;
            }
            break;
        }
        case QEvent::MouseButtonRelease:
            m_isDragging = false;
            break;
        default:
            break;
        }
        return QObject::eventFilter(obj, event);
    }
};

在QML中注册并使用过滤器：

ApplicationWindow {
    id: mainWindow
    flags: Qt.FramelessWindowHint
    visible: true

    Component.onCompleted: {
        let dragFilter = new WindowDragFilter()
        mainWindow.installEventFilter(dragFilter)
    }
}

关键注意事项 #

• 避免使用window.startSystemMove()，该方法会触发Qt的默认边界限制逻辑。
• 所有方案的核心都是手动计算窗口位置并直接设置，完全绕过系统的拖拽约束。

内容的提问来源于stack exchange，提问作者Mathieu Gauquelin