ToolTip QML Type

Bietet Tooltips für jedes Control. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Beigefügte Eigenschaften

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

Methoden

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

Beigefügte Methoden

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

Detaillierte Beschreibung

Ein Tooltip ist ein kurzer Textabschnitt, der den Benutzer über die Funktion eines Steuerelements informiert. Er wird normalerweise über oder unter dem übergeordneten Steuerelement platziert. Der Tipptext kann eine beliebige Rich-Text-formatierte Zeichenfolge sein.

Angehängte Tooltips

Der einfachste Weg, Tooltips für Steuerelemente einzurichten, ist die Angabe von text und visibility über angehängte Eigenschaften. Das folgende Beispiel veranschaulicht diesen Ansatz:

Button {
    text: qsTr("Save")

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

Unter normalen Umständen ist immer nur ein Tooltip sichtbar. Um Ressourcen zu sparen, teilen sich alle Elemente, die die angehängte Eigenschaft ToolTip verwenden, dieselbe visuelle ToolTip-Label-Instanz. Obwohl das Bildmaterial gemeinsam genutzt wird, werden text, timeout und delay für jedes Element, das die entsprechende angehängte Eigenschaft verwendet, einzeln gespeichert. Allerdings können nicht mehrere Elemente gleichzeitig die gemeinsame QuickInfo sichtbar machen. Der gemeinsame Tooltip wird nur für das letzte Element angezeigt, das ihn sichtbar gemacht hat. Die Position der gemeinsamen QuickInfo wird durch das Framework bestimmt.

Verzögerung und Timeout

Tooltipps sind in der Regel vorübergehend in dem Sinne, dass sie als Folge eines bestimmten externen Ereignisses oder einer Benutzerinteraktion angezeigt werden und normalerweise nach einer bestimmten Zeitspanne wieder ausgeblendet werden. Es ist möglich, die Verzögerung zu steuern, mit der ein Tooltip eingeblendet wird, und die Zeitspanne, nach der er ausgeblendet wird. Dadurch lassen sich unterschiedliche Strategien für das Ein- und Ausblenden von Tooltips umsetzen.

Auf Touchscreens ist es zum Beispiel üblich, dass ein Tooltip angezeigt wird, wenn eine Taste gedrückt und gehalten wird. Das folgende Beispiel zeigt, wie die Anzeige eines Tooltips verzögert werden kann, bis das Intervall für das Drücken und Halten erreicht ist. In diesem Beispiel wird die Werkzeugspitze ausgeblendet, sobald die Taste losgelassen wird.

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.")
}

Bei Zeigergeräten kann es jedoch erwünscht sein, dass ein Tooltip angezeigt wird, wenn eine Schaltfläche eine Weile in der Schwebe gehalten wird. Das folgende Beispiel zeigt, wie ein Tooltip angezeigt wird, wenn man eine Schaltfläche eine Sekunde lang in der Schwebe hält, und wie er nach einer Zeitspanne von fünf Sekunden wieder ausgeblendet wird.

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.")
}

Benutzerdefinierte Tooltips

Wenn eine feinere Kontrolle über die Position des Tooltips erforderlich ist oder mehrere Tooltips gleichzeitig benötigt werden, ist es auch möglich, lokale Tooltips zu erstellen. Auf diese Weise ist es möglich, die Werkzeugspitze anzupassen, und die gesamte API von Popup ist verfügbar. Das folgende Beispiel zeigt einen Tooltip, der den Wert eines Schiebereglers anzeigt, wenn der Griff gezogen wird.

Slider {
    id: slider
    value: 0.5

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

Siehe auch ToolTip, Popup-Steuerelemente und closePolicyanpassen.

Eigenschaft Dokumentation

Dokumentation der angehängten Eigenschaft

Dokumentation der Methode

Dokumentation der angehängten Methode