KitPressable
Primitive d’action qui centralise le pointeur, le clavier et le focus pour vos boutons personnalisés.

Placez du contenu non interactif dans ses enfants et donnez-lui un accessible-name. Choisissez ButtonIntent, ControlSize et ControlWidth.intrinsic ou .fill, ou fournissez une recipe.
activated signale une action acceptée ; disabled et busy empêchent son déclenchement. Entrée agit à l’appui, Espace au relâchement et cancel-press() annule un appui en cours.
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 { KitPressable, KitTheme, KitThemes } from "@kit/kit.slint";
export component Example inherits Window {
title: "KitPressable — exemple";
preferred-width: 360px;
preferred-height: 160px;
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: "Primitive d’action"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
KitPressable { theme: root.theme; accessible-name: "Ajouter à la collection"; activated => { root.status = "Ajouté à la collection"; } Text { text: "Ajouter à la collection"; color: root.theme.text-primary; horizontal-alignment: center; vertical-alignment: center; } }
if root.status != "": Text { text: root.status; color: root.theme.text-secondary; font-size: 12px * root.theme.text-scale; wrap: word-wrap; }
}
}
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 |
intent |
ButtonIntent |
in |
control-size |
ControlSize |
in |
control-width |
ControlWidth |
in |
recipe |
ButtonRecipe |
in |
accessible-name |
string |
in |
disabled |
bool |
in |
busy |
bool |
in |
tab-stop |
bool |
in |
hovered |
bool |
out |
pressed |
bool |
out |
has-focus |
bool |
out |
focus-visible |
bool |
out |
Types et variantes
Les noms ci-dessous utilisent la syntaxe Slint. Les types Rust partagés se trouvent dans slint_kit ; les enums de présentation proviennent des types Rust générés par Slint.
| Type | Déclaration |
|---|---|
enum ButtonIntent |
primary, secondary, quiet, destructive |
enum ControlSize |
compact, medium, comfortable |
enum ControlWidth |
intrinsic, fill |
Signaux
activated()activation-started()key-event(event: KeyEvent) → EventResultfocus-observed(bool)
Fonctions
cancel-press()take-focus()