NumberBox Classe

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Representa um controle que pode ser usado para exibir e editar números.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo 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

Herança

Control

NumberBox

Atributos

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Exemplos

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte a caixa Número.

Abra o aplicativo Galeria do WinUI 2 e veja o NumberBox em ação.

Os aplicativos da Galeria do WinUI 2 incluem exemplos interativos da maioria dos controles, recursos e funcionalidades do WinUI 2. Obtenha o aplicativo na Microsoft Store ou o código-fonte no GitHub.

Comentários

Esse controle dá suporte à validação, à etapa de incremento e à computação de cálculos embutidos de equações básicas, como multiplicação, divisão, adição e subtração.

Estilo e modelo de controle

Você pode modificar o Estilo e ControlTemplate padrão para dar ao controle uma aparência exclusiva. Para obter informações sobre como modificar o estilo e o modelo de um controle, consulte Estilos XAML. O estilo, o modelo e os recursos padrão que definem a aparência do controle são incluídos no generic.xaml arquivo. Para fins de design, generic.xaml é instalado com o pacote NuGet WinUI (Microsoft.UI.Xaml). Por padrão, esse local é \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Estilos e recursos de diferentes versões do WinUI podem ter valores diferentes.

O XAML também inclui recursos que você pode usar para modificar as cores de um controle em diferentes estados visuais sem modificar o modelo de controle. É preferível modificar esses recursos para definir propriedades como Plano de Fundo e Primeiro Plano. Para obter mais informações, consulte a seção Estilo leve do artigo Estilos XAML .

Construtores

NumberBox()

Inicializa uma nova instância da classe NumberBox . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Propriedades

AcceptsExpression	Alterna se o controle aceitará e avaliará uma expressão formulada básica inserida como entrada. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
AcceptsExpressionProperty	Identifica a propriedade de dependência AcceptsExpression . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Description	Obtém ou define o conteúdo mostrado abaixo do controle. O conteúdo deve fornecer diretrizes sobre a entrada esperada pelo controle. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
DescriptionProperty	Identifica a propriedade de dependência Description . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Header	Obtém ou define o conteúdo do cabeçalho do controle. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
HeaderProperty	Identifica a propriedade dependência Header . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
HeaderTemplate	Obtém ou define o DataTemplate usado para exibir o conteúdo do cabeçalho do controle. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
HeaderTemplateProperty	Identifica a propriedade de dependência HeaderTemplate . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsWrapEnabled	Alterna se a quebra de linha ocorrerá se uma linha de texto se estender além da largura disponível do controle. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsWrapEnabledProperty	Identifica a propriedade de dependência IsWrapEnabled . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
LargeChange	Obtém ou define o valor que é adicionado ou subtraído de Value quando uma grande alteração é feita, como com as chaves PageUP e PageDown. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
LargeChangeProperty	Identifica a propriedade de dependência LargeChange . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Maximum	Obtém ou define o máximo numérico para Valor. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MaximumProperty	Identifica a propriedade Dependência máxima . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Minimum	Obtém ou define o mínimo numérico para Valor. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MinimumProperty	Identifica a propriedade Dependência mínima . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
NumberFormatter	Obtém ou define o objeto usado para especificar a formatação de Value. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
NumberFormatterProperty	Identifica a propriedade de dependência NumberFormatter . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
PlaceholderText	Obtém ou define o texto exibido no controle até que o valor seja alterado por uma ação do usuário ou por alguma outra operação. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
PlaceholderTextProperty	Identifica a propriedade de dependência PlaceholderText . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
PreventKeyboardDisplayOnProgrammaticFocus	Obtém ou define um valor que indica se o teclado virtual é mostrado quando o controle recebe o foco programaticamente. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
PreventKeyboardDisplayOnProgrammaticFocusProperty	Identifica a propriedade de dependência PreventKeyboardDisplayOnProgrammaticFocus . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectionFlyout	Obtém ou define o submenu mostrado quando o texto é selecionado ou nulo se nenhum submenu for mostrado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectionFlyoutProperty	Identifica a propriedade de dependência SelectionFlyout . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectionHighlightColor	Obtém ou define o pincel usado para realçar o texto selecionado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SelectionHighlightColorProperty	Identifica a propriedade de dependência SelectionHighlightColor . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SmallChange	Obtém ou define o valor que é adicionado ou subtraído de Value quando uma pequena alteração é feita, como com uma tecla de seta ou rolagem. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SmallChangeProperty	Identifica a propriedade de dependência SmallChange . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SpinButtonPlacementMode	Obtém ou define um valor que indica o posicionamento de botões usados para incrementar ou diminuir a propriedade Value . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SpinButtonPlacementModeProperty	Identifica a propriedade de dependência SpinButtonPlacementMode . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Text	Obtém ou define a representação de tipo de cadeia de caracteres da propriedade Value . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TextProperty	Identifica a propriedade Dependência de texto . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TextReadingOrder	Obtém ou define um valor que indica como a ordem de leitura é determinada para a NumberBox. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TextReadingOrderProperty	Identifica a propriedade de dependência TextReadingOrder . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ValidationMode	Obtém ou define o comportamento de validação de entrada a ser invocado quando a entrada inválida é inserida. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ValidationModeProperty	Identifica a propriedade de dependência ValidationMode . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Value	Obtém ou define o valor numérico de um NumberBox. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ValueProperty	Identifica a propriedade de dependência Value . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Eventos

ValueChanged

Ocorre depois que o usuário dispara a avaliação de uma nova entrada pressionando a tecla Enter, clicando em um botão de rotação ou alterando o foco. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Confira também

• NumberBoxSpinButtonPlacementMode
• NumberBoxValidationMode
• NumberBoxValueChangedEventArgs