ToolTip QML Type

任意のコントロールのツールチップを提供します。詳細...

• 継承されたメンバを含むすべてのメンバのリスト

プロパティ

• delay : int
• text : string
• timeout : int

付属プロパティ

• delay : int
• text : string
• timeout : int
• toolTip : ToolTip
• visible : bool

メソッド

• void hide() (since QtQuick.Controls 2.5 (Qt 5.12))
• void show(string text, int timeout) (since QtQuick.Controls 2.5 (Qt 5.12))

付属メソッド

• void hide()
• void show(string text, int timeout)

詳細説明

ツールチップは、コントロールの機能をユーザーに知らせる短いテキストです。通常、親コントロールの上または下に配置されます。ヒントテキストは、リッチテキスト形式の文字列です。

添付ツールヒント

コントロールのツールチップを設定する最も簡単な方法は、アタッチドプロパティでtext とvisibility を指定することである。次の例は、この方法を示している：

Button {
    text: qsTr("Save")

    ToolTip.visible: down
    ToolTip.text: qsTr("Save the active project")
}

通常の状況では、一度に表示されるツール・チップは1つだけである。リソースを節約するために、ToolTip 添付プロパティを使用するすべてのアイテムは、同じビジュアルツールチップラベルインスタンスを共有します。ビジュアルが共有されていても、text 、timeout 、delay は、それぞれの添付プロパティを使用するアイテムごとに個別に保存されます。ただし、複数のアイテムが同時に共有ツールチップを表示することはできません。共有ツールチップは、最後に表示されたアイテムにのみ表示 されます。共有ツールチップの位置は、フレームワークによって決定されます。

ディレイとタイムアウト

ツール・チップは通常、特定の外部イベントまたはユーザー・インタラクションの結果として表示されるという意味で一時的なものであり、通常は一定のタイムアウト後に非表示になります。ツール・チップが表示されるときのディレイと、非表示になるときのタイムアウトを制御することが可能です。これにより、ツール・チップの表示と非表示にさまざまな戦略を実装することができます。

例えば、タッチスクリーンでは、ボタンを押し続けるとツールチップが表示されるのが一般的なパターンです。次の例では、長押し間隔に達するまでツール・チップの表示を遅らせる方法を示します。この例では、ボタンを離すとすぐにツールチップが隠れます。

Button {
    text: qsTr("Button")

    ToolTip.visible: pressed
    ToolTip.delay: Application.styleHints.mousePressAndHoldInterval
    ToolTip.text: qsTr("This tool tip is shown after pressing and holding the button down.")
}

しかし、ポインターデバイスでは、ボタンをしばらくホバーした結果としてツールチップを表示したい場合があります。次の例では、ボタンを1秒間ホバーした後にツールチップを表示し、5秒間のタイムアウト後に非表示にする方法を示します。

Button {
    text: qsTr("Button")
    hoverEnabled: true

    ToolTip.delay: 1000
    ToolTip.timeout: 5000
    ToolTip.visible: hovered
    ToolTip.text: qsTr("This tool tip is shown after hovering the button for a second.")
}

カスタムツールチップ

ツール・チップの位置をより細かく制御する必要がある場合、または複数のツール・チップ・インスタンスを同時に表示する必要がある場合、ローカル・ツール・チップ・インスタンスを作成することも可能です。この方法では、ツールチップをカスタマイズでき、Popup API全体を利用できます。次の例は、ハンドルをドラッグしたときにスライダーの値を表示するツールチップです。

Slider {
    id: slider
    value: 0.5

    ToolTip {
        parent: slider.handle
        visible: slider.pressed
        text: slider.value.toFixed(1)
    }
}

ツールチップのカスタマイズ、ポップアップコントロール、closePolicyも参照してください 。

プロパティの説明

付属プ ロパテ ィ 文書

メソッドの説明

アタッチメソッドのドキュメント