NumberBox Classe

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Représente un contrôle qui permet d’afficher et de modifier des nombres.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class NumberBox : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class NumberBox : Control

Public Class NumberBox
Inherits Control

Héritage

Control

NumberBox

Attributs

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez zone Nombre.

Ouvrez l’application Galerie WinUI 2 et voyez numberBox en action.

L’application WinUI 2 Gallery comprend des exemples interactifs de la plupart des contrôles et fonctionnalités WinUI 2. Procurez-vous l’application sur le Microsoft Store ou le code source sur GitHub.

Remarques

Ce contrôle prend en charge la validation, l’incrémentation et le calcul des calculs inline d’équations de base telles que la multiplication, la division, l’addition et la soustraction.

Modèle et style de contrôle

Vous pouvez modifier le Style par défaut et ControlTemplate pour donner au contrôle une apparence unique. Pour plus d’informations sur la modification du style et du modèle d’un contrôle, consultez Styles XAML. Le style, le modèle et les ressources par défaut qui définissent l’apparence du contrôle sont inclus dans le generic.xaml fichier. À des fins de conception, generic.xaml est installé avec le package NuGet WinUI (Microsoft.UI.Xaml). Par défaut, l'emplacement est \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Les styles et les ressources de différentes versions de WinUI peuvent avoir des valeurs différentes.

XAML inclut également des ressources que vous pouvez utiliser pour modifier les couleurs d’un contrôle dans différents états visuels sans modifier le modèle de contrôle. La modification de ces ressources est préférable à la définition de propriétés telles que l’arrière-plan et le premier plan. Pour plus d’informations, consultez la section Style léger de l’article Styles XAML .

Constructeurs

NumberBox()

Initialise une nouvelle instance de la classe NumberBox. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Propriétés

AcceptsExpression	Indique si le contrôle accepte et évalue une expression formule de base entrée en tant qu’entrée. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
AcceptsExpressionProperty	Identifie la propriété de dépendance AcceptExpression . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
Description	Obtient ou définit le contenu affiché sous le contrôle. Le contenu doit fournir des conseils sur l’entrée attendue par le contrôle. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
DescriptionProperty	Identifie la propriété de dépendance Description . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
Header	Obtient ou définit le contenu de l’en-tête du contrôle. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
HeaderProperty	Identifie la propriété de dépendance En-tête . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
HeaderTemplate	Obtient ou définit le DataTemplate utilisé pour afficher le contenu de l’en-tête du contrôle. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
HeaderTemplateProperty	Identifie la propriété de dépendance HeaderTemplate . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
IsWrapEnabled	Indique si le saut de ligne se produit si une ligne de texte s’étend au-delà de la largeur disponible du contrôle. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
IsWrapEnabledProperty	Identifie la propriété de dépendance IsWrapEnabled . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
LargeChange	Obtient ou définit la valeur ajoutée à Value ou soustraite à Value lorsqu’une modification importante est apportée, par exemple avec les touches PageUP et PageDown. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
LargeChangeProperty	Identifie la propriété de dépendance LargeChange . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
Maximum	Obtient ou définit le maximum numérique pour Value. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MaximumProperty	Identifie la propriété De dépendance maximale . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
Minimum	Obtient ou définit le minimum numérique pour Value. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MinimumProperty	Identifie la propriété de dépendance Minimale . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
NumberFormatter	Obtient ou définit l’objet utilisé pour spécifier la mise en forme de Value. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
NumberFormatterProperty	Identifie la propriété de dépendance NumberFormatter . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
PlaceholderText	Obtient ou définit le texte affiché dans le contrôle jusqu’à ce que la valeur soit modifiée par une action utilisateur ou une autre opération. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
PlaceholderTextProperty	Identifie la propriété de dépendance PlaceholderText . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
PreventKeyboardDisplayOnProgrammaticFocus	Obtient ou définit une valeur qui indique si le clavier à l’écran s’affiche lorsque le contrôle reçoit le focus par programmation. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
PreventKeyboardDisplayOnProgrammaticFocusProperty	Identifie la propriété de dépendance PreventKeyboardDisplayOnProgrammaticFocus . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SelectionFlyout	Obtient ou définit le menu volant qui s’affiche lorsque le texte est sélectionné, ou null si aucun menu volant n’est affiché. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SelectionFlyoutProperty	Identifie la propriété de dépendance SelectionFlyout . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SelectionHighlightColor	Obtient ou définit le pinceau utilisé pour mettre en surbrillance le texte sélectionné. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SelectionHighlightColorProperty	Identifie la propriété de dépendance SelectionHighlightColor . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SmallChange	Obtient ou définit la valeur ajoutée à Value ou soustraite à Value lorsqu’une petite modification est apportée, par exemple avec une touche de direction ou un défilement. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SmallChangeProperty	Identifie la propriété de dépendance SmallChange . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SpinButtonPlacementMode	Obtient ou définit une valeur qui indique l’emplacement des boutons utilisés pour incrémenter ou décrémenter la propriété Value . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SpinButtonPlacementModeProperty	Identifie la propriété de dépendance SpinButtonPlacementMode . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
Text	Obtient ou définit la représentation de type de chaîne de la propriété Value . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
TextProperty	Identifie la propriété de dépendance Text . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
TextReadingOrder	Obtient ou définit une valeur qui indique comment l’ordre de lecture est déterminé pour numberBox. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
TextReadingOrderProperty	Identifie la propriété de dépendance TextReadingOrder . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ValidationMode	Obtient ou définit le comportement de validation d’entrée à appeler en cas d’entrée non valide. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ValidationModeProperty	Identifie la propriété de dépendance ValidationMode . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
Value	Obtient ou définit la valeur numérique d’un NumberBox. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ValueProperty	Identifie la propriété de dépendance Value . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Événements

ValueChanged

Se produit après que l’utilisateur a déclenché l’évaluation de la nouvelle entrée en appuyant sur la touche Entrée, en cliquant sur un bouton de rotation ou en modifiant le focus. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Voir aussi

• NumberBoxSpinButtonPlacementMode
• NumberBoxValidationMode
• NumberBoxValueChangedEventArgs