KitMenuBar
Barre horizontale d’actions de navigation à identité stable.

Fournissez OptionRow et SelectState depuis le contrôleur et acceptez les activations par token et génération. Utilisez-la pour une rangée d’actions ou de destinations.
Les flèches gauche et droite demandent les étapes précédente et suivante. Le défilement horizontal révèle l’élément actif lorsque la barre dépasse sa largeur disponible.
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 { KitMenuBar, KitTheme, KitThemes, SelectionAvailability } from "@kit/kit.slint";
export component Example inherits Window {
title: "KitMenuBar — exemple";
preferred-width: 420px;
preferred-height: 180px;
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: "Barre de menus"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
KitMenuBar { accessible-name: "Actions"; theme: root.theme; rows: [{ token: 11, generation: 1, label: "Vue d’ensemble", description: "Résumé du projet", disabled: false }, { token: 23, generation: 1, label: "Activité", description: "Modifications récentes", disabled: false }, { token: 38, generation: 1, label: "Réglages", description: "Préférences du projet", disabled: false }]; state: { open: false, generation: 1, active-index: 0, active: { present: true, token: 11 }, selected: { present: true, token: 11 }, selection-availability: SelectionAvailability.available }; activate(token, generation) => { root.status = "Activation demandée pour l’identifiant stable " + token; } }
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 |
control-size |
ControlSize |
in |
rows |
[OptionRow] |
in |
state |
SelectState |
in |
accessible-name |
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 CloseReason |
escape, outside-press, system-back, trigger-toggle, programmatic, host-closed |
enum ControlSize |
compact, medium, comfortable |
enum NavigationStep |
next, previous, first, last, page-next, page-previous |
struct OptionRow |
token: int, generation: int, label: string, description: string, disabled: bool |
enum SelectionAvailability |
absent, available, unavailable |
struct SelectionRef |
present: bool, token: int |
struct SelectState |
selection-availability: SelectionAvailability, selected: SelectionRef, active: SelectionRef, open: bool, active-index: int, generation: int |
Signaux
navigate(NavigationStep)activate(int, int)dismiss(CloseReason)typeahead(string)
Fonctions
take-focus()reveal(left: length, right: length)handle-key(event: KeyEvent) → EventResult