NumberBox Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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).
/// [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 : ControlPublic Class NumberBox
Inherits Control- Herencia
-
NumberBox
- Atributos
-
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute
Ejemplos
Sugerencia
Para obtener más información, instrucciones de diseño y ejemplos de código, consulta el cuadro Número.
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). |
| InputScope |
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). |
| InputScopeProperty |
Identifica la propiedad de dependencia InputScope. (No se admite). 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). |
| TextAlignment |
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). |
| TextAlignmentProperty |
Identifica la propiedad de dependencia TextAlignment . 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). |