NumberBox Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

Representa un control que se puede usar para mostrar y editar números.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para 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

Herencia

Control

NumberBox

Atributos

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Ejemplos

Sugerencia

Para obtener más información, instrucciones de diseño y ejemplos de código, consulta el cuadro Número.

Abra la aplicación Galería de WinUI 2 y vea NumberBox en acción.

La aplicación WinUI 2 Gallery incluye ejemplos interactivos de la mayoría de los controles, características y funcionalidades de WinUI 2. Obtenga la aplicación en Microsoft Store u obtenga el código fuente en GitHub.

Comentarios

Este control admite la validación, la ejecución paso a paso de incremento y los cálculos en línea de ecuaciones básicas, como la multiplicación, la división, la suma y la resta.

Estilo de control y plantilla

Puede modificar el Estilo predeterminado y ControlTemplate para dar al control una apariencia única. Para obtener información sobre cómo modificar el estilo y la plantilla de un control, consulta Estilos XAML. El estilo, la plantilla y los recursos predeterminados que definen la apariencia del control se incluyen en el generic.xaml archivo . Para fines de diseño, generic.xaml se instala con el paquete NuGet WinUI (Microsoft.UI.Xaml). De forma predeterminada, la ubicación es \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Los estilos y recursos de diferentes versiones de WinUI pueden tener valores diferentes.

XAML también incluye recursos que puedes usar para modificar los colores de un control en distintos estados visuales sin modificar la plantilla de control. Se prefiere modificar estos recursos para establecer propiedades como Fondo y Primer plano. Para obtener más información, consulta la sección Estilo ligero del artículo Estilos XAML .

Constructores

NumberBox()

Inicializa una nueva instancia de la clase NumberBox . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Propiedades

AcceptsExpression	Alterna si el control aceptará y evaluará una expresión fórmula básica especificada como entrada. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
AcceptsExpressionProperty	Identifica la propiedad de dependencia AcceptsExpression . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
Description	Obtiene o establece el contenido que se muestra debajo del control . El contenido debe proporcionar instrucciones sobre la entrada esperada por el control. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
DescriptionProperty	Identifica la propiedad de dependencia Description . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
Header	Obtiene o establece el contenido del encabezado del control. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
HeaderProperty	Identifica la propiedad de dependencia Header . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
HeaderTemplate	Obtiene o establece la clase DataTemplate usada para mostrar el contenido del encabezado del control. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
HeaderTemplateProperty	Identifica la propiedad de dependencia HeaderTemplate . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsWrapEnabled	Alterna si se produce un salto de línea si una línea de texto se extiende más allá del ancho disponible del control. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsWrapEnabledProperty	Identifica la propiedad de dependencia IsWrapEnabled . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
LargeChange	Obtiene o establece el valor que se agrega o resta de Value cuando se realiza un cambio grande, como con las claves PageUP y PageDown. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
LargeChangeProperty	Identifica la propiedad de dependencia LargeChange . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
Maximum	Obtiene o establece el máximo numérico para Value. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MaximumProperty	Identifica la propiedad de dependencia Maximum . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
Minimum	Obtiene o establece el mínimo numérico para Value. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
MinimumProperty	Identifica la propiedad de dependencia Mínima . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
NumberFormatter	Obtiene o establece el objeto utilizado para especificar el formato de Value. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
NumberFormatterProperty	Identifica la propiedad de dependencia NumberFormatter . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
PlaceholderText	Obtiene o establece el texto que se muestra en el control hasta que una acción de usuario cambia el valor o alguna otra operación. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
PlaceholderTextProperty	Identifica la propiedad de dependencia PlaceholderText . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
PreventKeyboardDisplayOnProgrammaticFocus	Obtiene o establece un valor que indica si se muestra el teclado en pantalla cuando el control recibe el foco mediante programación. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
PreventKeyboardDisplayOnProgrammaticFocusProperty	Identifica la propiedad de dependencia PreventKeyboardDisplayOnProgrammaticFocus . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SelectionFlyout	Obtiene o establece el control flotante que se muestra cuando se selecciona texto o null si no se muestra ningún control flotante. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SelectionFlyoutProperty	Identifica la propiedad de dependencia SelectionFlyout . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SelectionHighlightColor	Obtiene o establece el pincel usado para resaltar el texto seleccionado. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SelectionHighlightColorProperty	Identifica la propiedad de dependencia SelectionHighlightColor . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SmallChange	Obtiene o establece el valor que se agrega o resta de Value cuando se realiza un pequeño cambio, como con una tecla de flecha o un desplazamiento. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SmallChangeProperty	Identifica la propiedad de dependencia SmallChange . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SpinButtonPlacementMode	Obtiene o establece un valor que indica la ubicación de los botones usados para incrementar o disminuir la propiedad Value . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SpinButtonPlacementModeProperty	Identifica la propiedad de dependencia SpinButtonPlacementMode . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
Text	Obtiene o establece la representación de tipo de cadena de la propiedad Value . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TextProperty	Identifica la propiedad de dependencia Text . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TextReadingOrder	Obtiene o establece un valor que indica cómo se determina el orden de lectura para numberBox. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
TextReadingOrderProperty	Identifica la propiedad de dependencia TextReadingOrder . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
ValidationMode	Obtiene o establece el comportamiento de validación de entrada que se va a invocar cuando se escribe una entrada no válida. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
ValidationModeProperty	Identifica la propiedad de dependencia ValidationMode . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
Value	Obtiene o establece el valor numérico de un objeto NumberBox. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
ValueProperty	Identifica la propiedad de dependencia Value . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Eventos

ValueChanged

Se produce después de que el usuario desencadene la evaluación de la nueva entrada presionando la tecla Entrar, haciendo clic en un botón de número o cambiando el foco. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Consulte también

• NumberBoxSpinButtonPlacementMode
• NumberBoxValidationMode
• NumberBoxValueChangedEventArgs