Slint Kit Documentation

Retour et progression

KitTooltip

Aide courte associée au survol et au focus d’un contrôle.

Aide courte associée au survol et au focus d’un contrôle.
Capture native du même exemple, moteur Skia.

Enveloppez le contrôle comme enfant, définissez text et liez target-focused à son has-focus. Montez un KitTooltipLayer à la racine de la fenêtre pour l’aide au clavier.

Le survol utilise une infobulle native transparente aux interactions ; le focus publie une projection dans la couche de fenêtre. Échap ou dismiss() masque l’aide jusqu’au prochain cycle de focus.

Exemple complet

Ce fichier Slint complet présente une composition visuelle et produit la capture ci-dessus. Les textes internes sans propriété de libellé conservent la langue par défaut du kit ; les dialogues système suivent la plateforme. Les états projetés et les signaux qui demandent une décision doivent être raccordés à l’hôte ; cet exemple isolé ne fournit pas ce contrôleur. Configurer le projet Rust, puis consulter l’application avec contrôleurs typés pour relier réellement édition, validation et sélection.

// Public label overrides localize this fixture; toolkit/host defaults keep their language.
// SPDX-License-Identifier: GPL-3.0-or-later
import { KitButton, KitTheme, KitThemes, KitTooltip, KitTooltipLayer } from "@kit/kit.slint";

export component Example inherits Window {
    title: "KitTooltip — exemple";
    preferred-width: 360px;
    preferred-height: 220px;
    max-width: 100000px;
    max-height: 100000px;
    background: root.theme.canvas;
    in-out property <KitTheme> theme: KitThemes.light;
    in-out property <string> status;
    VerticalLayout {
        padding: 24px; spacing: 16px; alignment: start;
        Text { text: "Infobulle"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitTooltip { theme: root.theme; text: "Créez un projet dans cet espace de travail."; target-focused: true; viewport-width: root.width; viewport-height: root.height; KitButton { theme: root.theme; text: "Nouveau projet"; activated => { root.status = "Action demandée"; } } }
        if root.status != "": Text { text: root.status; color: root.theme.text-secondary; font-size: 12px * root.theme.text-scale; wrap: word-wrap; }
    }
    KitTooltipLayer { viewport-width: root.width; viewport-height: root.height; }
}

Télécharger cet exemple

API publique

Hérite de Rectangle. Les déclarations suivantes sont extraites des sources du composant. Les propriétés du parent restent disponibles ; les détails de gestion d’état sont décrits dans le guide des contrôleurs.

Propriétés

Nom Type Sens
theme KitTheme in
text string in
target-focused bool in
viewport-width length in
viewport-height length in
keyboard-visible bool out

Fonctions

Voir aussi