ToolTip QML Type

Fournit des info-bulles pour n'importe quel contrôle. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Propriétés rattachées

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

Méthodes

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

Méthodes attachées

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

Description détaillée

Une info-bulle est un court texte qui informe l'utilisateur de la fonction d'un contrôle. Elle est généralement placée au-dessus ou au-dessous du contrôle parent. Le texte de l'info-bulle peut être n'importe quelle chaîne de texte riche formatée.

Info-bulles attachées

La façon la plus directe de configurer les bulles d'aide pour les contrôles est de spécifier text et visibility via les propriétés attachées. L'exemple suivant illustre cette approche :

Button {
    text: qsTr("Save")

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

Dans des circonstances normales, il n'y a qu'une seule info-bulle visible à la fois. Afin d'économiser des ressources, tous les éléments qui utilisent la propriété attachée ToolTip partagent la même instance visuelle d'étiquette d'info-bulle. Même si les visuels sont partagés, text, timeout et delay sont stockés individuellement pour chaque élément qui utilise la propriété attached respective. Cependant, plusieurs éléments ne peuvent pas rendre l'info-bulle partagée visible en même temps. La bulle d'aide partagée n'est affichée que pour le dernier élément qui l'a rendue visible. La position de l'info-bulle partagée est déterminée par le cadre.

Délai et temporisation

Les info-bulles sont généralement transitoires, c'est-à-dire qu'elles sont affichées à la suite d'un événement externe ou d'une interaction avec l'utilisateur, et elles disparaissent généralement après un certain délai. Il est possible de contrôler le délai d'affichage d'une info-bulle et le délai de masquage. Cela permet de mettre en œuvre différentes stratégies d'affichage et de masquage des info-bulles.

Par exemple, sur les écrans tactiles, il est courant d'afficher une info-bulle lorsqu'on appuie sur un bouton et qu'on le maintient enfoncé. L'exemple suivant montre comment retarder l'affichage d'une info-bulle jusqu'à ce que l'intervalle de pression et de maintien soit atteint. Dans cet exemple, l'info-bulle disparaît dès que le bouton est relâché.

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

Avec les dispositifs de pointage, cependant, il peut être souhaitable d'afficher une bulle d'aide après avoir survolé un bouton pendant un certain temps. L'exemple suivant montre comment afficher une bulle d'aide après avoir survolé un bouton pendant une seconde, et comment la masquer après un délai de cinq secondes.

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

Info-bulles personnalisées

Si l'on a besoin d'un contrôle plus fin sur la position de la bulle d'aide, ou si l'on a besoin de plusieurs bulles d'aide simultanées, il est également possible de créer des bulles d'aide locales. De cette manière, il est possible de personnaliser l'info-bulle et l'ensemble de l'API Popup est disponible. L'exemple suivant présente une info-bulle qui indique la valeur d'un curseur lorsque la poignée est déplacée.

Slider {
    id: slider
    value: 0.5

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

Voir également Personnalisation de la bulle d'aide, Contrôles contextuels et closePolicy.

Documentation sur les propriétés

delay : int

Cette propriété définit le délai (en millisecondes) après lequel l'info-bulle est affichée. Une info-bulle dont le délai est négatif est affichée immédiatement. La valeur par défaut est 0.

Voir également Delay and Timeout.

text : string

Cette propriété contient le texte affiché dans la bulle d'aide.

timeout : int

Cette propriété définit le délai (en millisecondes) après lequel l'info-bulle est masquée. Une info-bulle dont le délai d'attente est négatif ne se cache pas automatiquement. La valeur par défaut est -1.

Voir également Delay and Timeout.

Documentation sur la propriété Attached

ToolTip.delay : int

Cette propriété attachée contient le délai (en millisecondes) de la pointe de l'outil partagé. Cette propriété peut être attachée à n'importe quel élément.

Voir également Attached Tool Tips et Delay and Timeout.

ToolTip.text : string

Cette propriété jointe contient le texte de l'info-bulle partagée. Cette propriété peut être attachée à n'importe quel élément.

Voir aussi Attached Tool Tips.

ToolTip.timeout : int

Cette propriété jointe définit le délai d'attente (en millisecondes) de l'info-bulle partagée. Cette propriété peut être attachée à n'importe quel élément.

Voir également Attached Tool Tips et Delay and Timeout.

ToolTip.toolTip : ToolTip

Cette propriété jointe contient l'instance partagée de l'info-bulle. Cette propriété peut être attachée à n'importe quel élément.

Voir aussi Attached Tool Tips.

ToolTip.visible : bool

Cette propriété jointe indique si la bulle d'aide partagée est visible. Cette propriété peut être attachée à n'importe quel élément.

Voir aussi Attached Tool Tips.

Documentation de la méthode

[since QtQuick.Controls 2.5 (Qt 5.12)] void hide()

Cette méthode permet de masquer l'infobulle.

Cette méthode a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

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

Cette méthode affiche l'adresse text sous la forme d'une infobulle, dont la durée est calculée en timeout (millisecondes).

Cette méthode a été introduite dans QtQuick.Controls 2.5 (Qt 5.12).

Documentation de la méthode attachée

void hide()

Cette méthode jointe masque l'infobulle partagée. Cette méthode peut être attachée à n'importe quel élément.

Voir aussi Attached Tool Tips.

void show(string text, int timeout = -1)

Cette méthode jointe affiche l'infobulle partagée avec text et timeout (millisecondes). La méthode peut être attachée à n'importe quel élément.

Voir aussi Attached Tool Tips.