Qt.ClickFocus在QML中的实际用途？焦点行为测试疑问

问题场景 #

你编写了测试代码研究QML焦点行为，给两个Rectangle设置了focusPolicy: Qt.StrongFocus（等价于Qt.ClickFocus | Qt.TabFocus），发现Tab键能正常切换焦点，但点击Rectangle时无法触发焦点获取，想搞清楚Qt.ClickFocus的真正作用。

测试代码：

import QtQuick
import QtQuick.Window

Window {
    visible: true
    width: 600
    height: 600

    Rectangle {
        width: 600
        height: 600
        color: "lightgray"

        // Nested rectangles
        Rectangle {
            width: parent.width / 2 - 15
            height: parent.height / 2 - 15
            focus: true
            focusPolicy: Qt.StrongFocus
            anchors {
                left: parent.left
                top: parent.top
                leftMargin: 10
                topMargin: 10
            }
            color: "blue"

            onActiveFocusChanged: {
                if (activeFocus)
                    console.log("blue got focus")
            }
        }

        Rectangle {
            width: parent.width / 2 - 15
            height: parent.height / 2 - 15
            focusPolicy: Qt.StrongFocus
            anchors {
                right: parent.right
                top: parent.top
                rightMargin: 10
                topMargin: 10
            }
            color: "green"

            onActiveFocusChanged: {
                if (activeFocus)
                    console.log("green got focus")
            }
        }
    }
}

核心原因与Qt.ClickFocus的用途 #

为什么你的Rectangle点击不触发焦点？ #

Rectangle是QML的基础图形项，本身没有内置鼠标点击事件的处理逻辑来响应Qt.ClickFocus。focusPolicy只是告诉框架「这个项可以通过哪种方式获取焦点」，但前提是项本身能处理对应的触发事件（比如点击、Tab切换）。

Qt.ClickFocus的真正作用 #

Qt.ClickFocus是给原生交互式控件（比如Button、TextField、Slider这类）设计的：

• 这类控件内部已经实现了鼠标点击的事件处理，设置Qt.ClickFocus后，它们会在被点击时自动向焦点管理系统申请获取焦点，不需要手动写MouseArea和forceActiveFocus()。
• 自定义交互式控件时，只要你在控件内部实现了鼠标点击的事件响应逻辑，配合Qt.ClickFocus就能让控件自动利用框架的焦点管理机制获取焦点，不用手动调用强制焦点的方法。

解决你的场景的方法 #

如果想让Rectangle点击时获取焦点，有两种常用方式：

1. 给Rectangle添加MouseArea，在点击时调用forceActiveFocus()：

   Rectangle {
       // ... 其他属性
       MouseArea {
           anchors.fill: parent
           onClicked: parent.forceActiveFocus()
       }
   }
   

2. 将Rectangle替换为原生Button（如果场景适合），它自带点击获焦的逻辑：

   Button {
       text: "Green"
       focusPolicy: Qt.StrongFocus
       // ... 其他布局属性
       onActiveFocusChanged: {
           if (activeFocus) console.log("green got focus")
       }
   }
   

内容的提问来源于stack exchange，提问作者Michał Walenciak