SpinButton contrôle (version préliminaire)

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Un contrôle utilisé pour accepter l’entrée utilisateur.

Note

La documentation complète et le code source sont accessibles dans le Référentiel de composants de code GitHub.

Important

• Cette fonctionnalité est une fonctionnalité en version préliminaire.
• Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.

Description

Un bouton rotatif (SpinButton) permet à quelqu’un d’ajuster progressivement une valeur par petites étapes. Il est principalement utilisé pour les valeurs numériques, mais d’autres valeurs sont également prises en charge.

Ce composant de code fournit un wrapper autour du contrôle SpinButton de l’interface utilisateur Fluent à utiliser dans les applications canevas et les pages personnalisées.

Propriétés principales

Nom	Description
Label	Intitulé descriptif du contrôle.
IconName	Nom de l’icône Fluent UI à utiliser (voir Icônes Fluent UI).
Min	Valeur maximale du contrôle. S’il n’est pas fourni, le contrôle n’a pas de valeur maximale.
Max	Valeur minimale du contrôle. S’il n’est pas fourni, le contrôle n’a pas de valeur minimale.
Step	Différence entre deux valeurs adjacentes du contrôle. Cette valeur est utilisée pour calculer la précision de l’entrée si aucune précision n’est donnée. La précision ainsi calculée sera toujours >= 0.
Value	Valeur actuelle du contrôle.
DefaultValue	Valeur initiale du contrôle lors du premier rendu.
Suffix	Suffixe pour définir n’importe quelle unité (par exemple cm, kg, ml)

Propriétés supplémentaires

Nom	Description
AccessibilityLabel	Étiquette aria pour les lecteurs d’écran
InputEvent	Un événement à envoyer au contrôle. Par exemple, SetFocus. Voir ci-dessous.
Theme	Accepte une chaîne JSON générée à l’aide du Concepteur de thème Fluent UI (windows.net). Si vous laissez ce champ vide, le thème par défaut défini par Power Apps sera utilisé.

Behavior

• Prend en charge SetFocus en tant que InputEvent.

Exemple

Connexion de SpinButton à une carte de données Edit Form

1. Déverrouillez la carte de données
2. Masquer le contrôle par défaut du champ
3. Ajouter le SpinButton dans la carte de données
4. Mettez à jour la propriété Update de la carte de données pour référencer la propriété SpinButton.Value de sortie

Limitations

Ce composant de code ne peut être utilisé que dans les applications canevas et les pages personnalisées.