Freigeben über


NumberBox Klasse

Definition

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).

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
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(Microsoft.UI.Xaml.XamlContract, 65536)]
class NumberBox : Control
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public 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
NumberBox
Attribute
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute

Beispiele

Tipp

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

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).

InputScope

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).

InputScopeProperty

Identifiziert die InputScope-Abhängigkeitseigenschaft. (Nicht unterstützt.)

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).

TextAlignment

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).

TextAlignmentProperty

Identifiziert die TextAlignment-Abhängigkeitseigenschaft .

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).

Gilt für:

Weitere Informationen