Slint Kit Documentation

Fichiers

KitFileDropZone

Zone de dépôt de fichiers activée par une capacité réelle de l’hôte.

Zone de dépôt de fichiers activée par une capacité réelle de l’hôte.
Capture native du même exemple, moteur Skia.

Définissez DropCapability.available uniquement après vérification du backend. Vérifiez les formats dans can-drop(DropEvent) et résolvez les données natives de manière asynchrone dans dropped.

Les deux callbacks retournent un DragAction explicite. En mode .unsupported, la zone explique l’alternative ; les événements de pointeur seuls ne prouvent pas la prise en charge du dépôt externe.

Voir le code source ↗

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

export component Example inherits Window {
    title: "KitFileDropZone — exemple";
    preferred-width: 520px;
    preferred-height: 270px;
    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: "Zone de dépôt de fichiers"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitFileDropZone { label: "Déposez les fichiers ici"; unsupported-label: "Le glisser-déposer est indisponible ; utilisez Choisir des fichiers."; theme: root.theme; capability: DropCapability.unsupported; } KitButton { theme: root.theme; text: "Choisir des fichiers…"; 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; }
    }
}

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
control-size ControlSize in
access FieldAccess in
capability DropCapability in
label string in
unsupported-label string in
error string in
host-drag-hovered bool in
drag-hovered 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 ControlSize compact, medium, comfortable
enum DropCapability unsupported, available
enum FieldAccess editable, read-only, disabled

Signaux

Voir aussi