Slint Kit Documentation

Choix et valeurs

KitCheckbox

Case à cocher contrôlée avec un véritable état mixte.

Case à cocher contrôlée avec un véritable état mixte.
Capture native du même exemple, moteur Skia.

Projetez CheckState.unchecked, .checked ou .mixed et acceptez la demande toggled(CheckState) dans le contrôleur. Fournissez label et FieldAccess.

Une activation demande l’état coché sauf depuis .checked, qui demande l’état décoché. L’état mixte reste distinct et la lecture seule permet le focus sans modification.

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 { CheckState, KitCheckbox, KitTheme, KitThemes } from "@kit/kit.slint";

export component Example inherits Window {
    title: "KitCheckbox — 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: "Case à cocher"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitCheckbox { theme: root.theme; label: "Recevoir les nouveautés du produit"; state: CheckState.checked; toggled(state) => { root.status = "Changement de case à cocher demandé"; } }
        if root.status != "": Text { text: root.status; color: root.theme.text-secondary; font-size: 12px * root.theme.text-scale; wrap: word-wrap; }
    }
}

Télécharger cet exemple

API publique

Hérite de KitPressable. 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
state CheckState in
access FieldAccess in
label string in

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 CheckState unchecked, checked, mixed
enum FieldAccess editable, read-only, disabled

Signaux

Voir aussi