HusToolTip 文字提示

January 26, 2026 · View on GitHub

← 返回主目录

← 返回本类别目录

HusToolTip 文字提示

单的文字提示气泡框。

  • 模块 { HuskarUI.Basic }

  • 继承自 { ToolTip }


支持的代理:


支持的属性:

属性名类型默认值描述
animationEnabledboolHusTheme.animationEnabled是否开启动画
showArrowboolfalse是否显示箭头
positionenumHusToolTip.Position_Top文字提示的位置(来自 HusToolTip)
colorTextcolor-文本颜色
colorBgcolor-背景颜色

代码演示

示例 1

通过 showArrow 属性设置是否显示箭头

通过 position 属性设置文字提示的位置,支持的位置:

  • 文字提示在项目上方(默认){ HusToolTip.Position_Top }

  • 文字提示在项目下方{ HusToolTip.Position_Bottom }

  • 文字提示在项目左方{ HusToolTip.Position_Left }

  • 文字提示在项目右方{ HusToolTip.Position_Right }

import QtQuick
import QtQuick.Layouts
import HuskarUI.Basic

Column {
    width: parent.width
    spacing: 10

    GridLayout {
        width: 400
        rows: 3
        columns: 3

        HusButton {
            Layout.alignment: Qt.AlignHCenter
            Layout.columnSpan: 3
            text: qsTr('上方')

            HusToolTip {
                visible: parent.hovered
                showArrow: true
                text: qsTr('上方文字提示')
            }
        }

        HusButton {
            Layout.alignment: Qt.AlignLeft
            text: qsTr('左方')

            HusToolTip {
                visible: parent.hovered
                showArrow: true
                text: qsTr('左方文字提示')
                position: HusToolTip.Position_Left
            }
        }

        HusButton {
            Layout.alignment: Qt.AlignCenter
            text: qsTr('箭头中心')

            HusToolTip {
                x: 0
                visible: parent.hovered
                showArrow: true
                text: qsTr('箭头中心会自动指向 parent 的中心')
                position: HusToolTip.Position_Top
            }
        }

        HusButton {
            Layout.alignment: Qt.AlignRight
            text: qsTr('右方')

            HusToolTip {
                visible: parent.hovered
                showArrow: true
                text: qsTr('右方文字提示')
                position: HusToolTip.Position_Right
            }
        }

        HusButton {
            Layout.alignment: Qt.AlignHCenter
            Layout.columnSpan: 3
            text: qsTr('下方')

            HusToolTip {
                visible: parent.hovered
                showArrow: true
                text: qsTr('下方文字提示')
                position: HusToolTip.Position_Bottom
            }
        }
    }
}