NumberBox Klasse

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Stellt ein Steuerelement dar, das zum Anzeigen und Bearbeiten von Zahlen verwendet werden kann.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

/// [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

Vererbung

Control

NumberBox

Attribute

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Beispiele

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie im Feld Zahl.

Öffnen Sie die WinUI 2-Katalog-App, und sehen Sie sich numberBox in Aktion an.

Die App WinUI 2-Katalog umfasst interaktive Beispiele für die meisten WinUI 2-Steuerelemente, -Features und -Funktionen. Rufen Sie die App aus dem Microsoft Store oder den Quellcode auf GitHub ab.

Hinweise

Dieses Steuerelement unterstützt die Validierung, das Inkrementschritt und das Berechnen von Inlineberechnungen grundlegender Formeln wie Multiplikation, Division, Addition und Subtraktion.

Steuerelementstil und -vorlage

Sie können den Standardstil und die ControlTemplate ändern, um dem Steuerelement ein eindeutiges Erscheinungsbild zu verleihen. Informationen zum Ändern des Stils und der Vorlage eines Steuerelements finden Sie unter XAML-Formatvorlagen. Der Standardstil, die Vorlage und die Ressourcen, die das Erscheinungsbild des Steuerelements definieren, sind in der generic.xaml Datei enthalten. Zu Entwurfszwecken generic.xaml wird mit dem NuGet-Paket WinUI (Microsoft.UI.Xaml) installiert. Standardmäßig ist der Speicherort \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Stile und Ressourcen aus verschiedenen WinUI-Versionen können unterschiedliche Werte aufweisen.

XAML enthält auch Ressourcen, mit denen Sie die Farben eines Steuerelements in verschiedenen visuellen Zuständen ändern können, ohne die Steuerelementvorlage zu ändern. Das Ändern dieser Ressourcen wird bevorzugt, um Eigenschaften wie Hintergrund und Vordergrund festzulegen. Weitere Informationen finden Sie im Abschnitt Leichtes Formatieren des Artikels XAML-Formatvorlagen .

Konstruktoren

NumberBox()

Initialisiert eine neue instance der NumberBox-Klasse. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Eigenschaften

AcceptsExpression	Schaltet ein, ob das Steuerelement einen grundlegenden formelischen Ausdruck akzeptiert und auswertet, der als Eingabe eingegeben wurde. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
AcceptsExpressionProperty	Identifiziert die Abhängigkeitseigenschaft AcceptsExpression . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
Description	Ruft Inhalte ab, die unterhalb des -Steuerelements angezeigt werden, oder legt diesen fest. Der Inhalt sollte Anleitungen zu der vom -Steuerelement erwarteten Eingabe bieten. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
DescriptionProperty	Identifiziert die Description-Abhängigkeitseigenschaft. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
Header	Ruft den Inhalt für den -Header des Steuerelements ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
HeaderProperty	Identifiziert die Headerabhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
HeaderTemplate	Ruft die DataTemplate ab, die zum Anzeigen des Inhalts des Steuerelementheaders verwendet wird, oder legt sie fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
HeaderTemplateProperty	Identifiziert die HeaderTemplate-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
IsWrapEnabled	Schaltet ein, ob zeilenumbrüche auftreten, wenn eine Textzeile über die verfügbare Breite des Steuerelements hinausgeht. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
IsWrapEnabledProperty	Identifiziert die IsWrapEnabled-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
LargeChange	Ruft den Wert ab, der bei einer großen Änderung hinzugefügt oder daraus subtrahiert wird, z. B. mit den Tasten PageUP und PageDown. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
LargeChangeProperty	Identifiziert die LargeChange-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
Maximum	Ruft das numerische Maximum für Value ab oder legt dieses fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
MaximumProperty	Gibt die Maximale Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
Minimum	Ruft das numerische Minimum für Value ab oder legt dieses fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
MinimumProperty	Gibt die Minimum dependency-Eigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
NumberFormatter	Ruft das Objekt ab, das zum Angeben der Formatierung von Value verwendet wird, oder legt es fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
NumberFormatterProperty	Identifiziert die NumberFormatter-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
PlaceholderText	Ruft den Text ab, der im Steuerelement angezeigt wird, bis der Wert durch eine Benutzeraktion oder einen anderen Vorgang geändert wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
PlaceholderTextProperty	Identifiziert die PlaceholderText-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
PreventKeyboardDisplayOnProgrammaticFocus	Ruft einen Wert ab, der angibt, ob die Bildschirmtastatur angezeigt wird, wenn das Steuerelement programmgesteuert den Fokus erhält, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
PreventKeyboardDisplayOnProgrammaticFocusProperty	Identifiziert die Abhängigkeitseigenschaft PreventKeyboardDisplayOnProgrammaticFocus . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SelectionFlyout	Ruft das Flyout ab, das angezeigt wird, wenn Text ausgewählt wird, oder null , wenn kein Flyout angezeigt wird. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SelectionFlyoutProperty	Identifiziert die SelectionFlyout-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SelectionHighlightColor	Ruft den Pinsel ab, der zum Hervorheben des markierten Texts verwendet wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SelectionHighlightColorProperty	Gibt die SelectionHighlightColor-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SmallChange	Ruft den Wert ab, der hinzugefügt oder von Value subtrahiert wird, wenn eine kleine Änderung vorgenommen wird, z. B. mit einer Pfeiltaste oder einem Bildlauf. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SmallChangeProperty	Identifiziert die SmallChange-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SpinButtonPlacementMode	Ruft einen Wert ab, der die Platzierung von Schaltflächen angibt, die zum Erhöhen oder Verringern der Value-Eigenschaft verwendet werden, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SpinButtonPlacementModeProperty	Identifiziert die SpinButtonPlacementMode-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
Text	Ruft die Zeichenfolgentypdarstellung der Value-Eigenschaft ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TextProperty	Identifiziert die Text-Abhängigkeitseigenschaft. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TextReadingOrder	Ruft einen Wert ab, der angibt, wie die Lesereihenfolge für numberBox bestimmt wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TextReadingOrderProperty	Identifiziert die TextReadingOrder-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
ValidationMode	Ruft das Eingabevalidierungsverhalten ab, das aufgerufen werden soll, wenn ungültige Eingaben eingegeben werden, oder legt dieses fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
ValidationModeProperty	Identifiziert die ValidationMode-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
Value	Ruft den numerischen Wert eines NumberBox-Steuerelements ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
ValueProperty	Identifiziert die Value-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Ereignisse

ValueChanged

Tritt auf, nachdem der Benutzer die Auswertung der neuen Eingabe ausgelöst hat, indem er die EINGABETASTE drückt, auf eine Drehtaste klickt oder den Fokus ändert. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Weitere Informationen

• NumberBoxSpinButtonPlacementMode
• NumberBoxValidationMode
• NumberBoxValueChangedEventArgs