QML无边框窗口问题：DragHandler绑定失败+最大化覆盖任务栏

一、DragHandler设置窗口拖动报错问题 #

原因 #

DragHandler的target属性要求接收QQuickItem类型对象，但Window不属于QQuickItem子类，直接赋值会触发类型不匹配错误。

解决方法 #

无需给DragHandler指定窗口作为target，直接通过拖动事件调用窗口的系统移动接口即可：

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

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

        DragHandler {
            onActiveChanged: {
                if (active) mainWindow.startSystemMove()
            }
        }
    }
}

也可以用MouseArea实现相同效果：

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

    MouseArea {
        anchors.fill: parent
        property point lastMousePos
        onPressed: lastMousePos = Qt.point(mouseX, mouseY)
        onPositionChanged: {
            mainWindow.x += mouseX - lastMousePos.x
            mainWindow.y += mouseY - lastMousePos.y
        }
    }
}

二、窗口最大化后无法访问任务栏问题 #

原因 #

无边框窗口使用Window.Maximized时会默认占满整个屏幕，覆盖系统任务栏区域。

解决方法 #

手动设置窗口几何为屏幕可用区域（自动排除任务栏），而非直接使用Maximized属性：

ToolbarButton {
    id: maximizeBtn
    text: mainWindow.visibility === Window.Maximized ? "Restore" : "Maximize"
    onClicked: {
        if (mainWindow.visibility === Window.Maximized) {
            mainWindow.setGeometry(mainWindow.oldGeometry)
            mainWindow.visibility = Window.Windowed
        } else {
            mainWindow.oldGeometry = mainWindow.geometry
            mainWindow.x = 0
            mainWindow.y = 0
            mainWindow.width = Screen.width
            mainWindow.height = Screen.desktopAvailableHeight
        }
    }
}

如果需要保留Maximized属性，可在窗口状态变化时调整几何：

Window {
    id: mainWindow
    // 其他属性...
    onVisibilityChanged: {
        if (visibility === Window.Maximized) {
            geometry = Qt.rect(0, 0, Screen.width, Screen.desktopAvailableHeight)
        }
    }
}

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