QML Slider Tooltip始终可见异常问题求助

问题原因 #

Qt Quick Controls 2 的 Tooltip 组件内置了全局事件处理逻辑：当检测到鼠标点击控件外部、焦点切换到其他控件等操作时，会自动将自身的 visible 属性设为 false。即使你手动设置 visible: true 或 timeout: -1，这些内部的事件响应逻辑会优先覆盖你的设置——因为 Tooltip 的设计定位是临时提示组件，而非永久显示的元素，其内部逻辑默认会管理可见性状态。

解决方案 #

方法1：强制绑定 visible 属性，覆盖内部逻辑

通过 Binding 组件强制将 Tooltip 的 visible 锁定为 true，并启用 preventBindingLoop 避免循环绑定问题：

Slider {
    // 自定义Slider的其他配置...
    handle: Rectangle {
        id: customHandle
        width: 20
        height: 20
        color: "steelblue"
        radius: 10

        Tooltip {
            id: persistentTooltip
            text: "当前值: " + parent.parent.value
            timeout: -1 // 禁用超时隐藏
            // 强制绑定visible为true，覆盖内部逻辑
            Binding {
                target: persistentTooltip
                property: "visible"
                value: true
                preventBindingLoop: true
            }
        }
    }
}

方法2：用 Popup 替代 Tooltip，完全自定义控制

如果需要完全掌控显示逻辑，建议使用 Popup 组件自定义永久提示，避开 Tooltip 的内置行为：

Slider {
    // 自定义Slider的其他配置...
    handle: Rectangle {
        id: customHandle
        width: 20
        height: 20
        color: "steelblue"
        radius: 10

        Popup {
            visible: true
            modal: false // 不阻塞其他控件交互
            focus: false // 不抢夺焦点
            // 调整提示框位置，避免遮挡Handle
            x: customHandle.width + 5
            y: -height/2 + customHandle.height/2

            Label {
                text: "当前值: " + parent.parent.parent.value
                padding: 6
                color: "white"
                background: Rectangle {
                    color: "#444"
                    radius: 4
                }
            }
        }
    }
}

补充说明 #

• 你之前尝试的 focus 设置仅针对键盘焦点，与鼠标点击导致的 Tooltip 隐藏无关；timeout: -1 仅禁用超时自动隐藏，无法阻止全局事件触发的隐藏逻辑。
• 若用 MouseArea 控制可见性，需确保事件处理的优先级高于 Tooltip 的内部逻辑，不过这种方式不如上述两种方法可靠。

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