SpinButton control (vista previa)

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Un control utilizado para aceptar la entrada del usuario.

Nota

La documentación completa y el código fuente se encuentran en el repositorio de componentes de código GitHub.

Importante

• Esta es una característica en versión preliminar.
• Las funciones de vista previa no están diseñadas para un uso en producción y pueden tener funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.

Descripción

Un botón giratorio (SpinButton) permite que alguien ajuste gradualmente un valor en pequeños pasos. Se utiliza principalmente para valores numéricos, pero también se admiten otros valores.

Este componente de código proporciona una envoltura alrededor del control Fluent UI SpinButton para su uso en páginas de Canvas y personalizadas.

Propiedades importantes

Name	Descripción
Label	Etiqueta descriptiva del control.
IconName	Nombre del icono de Fluent UI (vea Iconos de Fluent UI).
Min	Valor máximo del control. Si no se proporciona, el control no tiene valor máximo.
Max	Valor mínimo del control. Si no se proporciona, el control no tiene valor mínimo.
Step	Diferencia entre dos valores adyacentes del control. Este valor se utiliza para calcular la precisión de la entrada si no se proporciona ninguna precisión. La precisión calculada de esta forma siempre será >= 0.
Value	Valor actual del control.
DefaultValue	Valor inicial del control cuando se muestra por primera vez.
Suffix	Sufijo para definir cualquier unidad (por ejemplo, cm, kg, ml)

Propiedades adicionales

Name	Descripción
AccessibilityLabel	aria-label para lectores de pantalla
InputEvent	Evento para enviar al control. por ejemplo, SetFocus. Consulte a continuación.
Theme	Acepta una cadena JSON que se genera usando Diseñador de temas de Fluent UI (windows.net). Si deja esto en blanco, usará el tema predeterminado definido por Power Apps.

Comportamiento

• Soporta SetFocus como un InputEvent.

Ejemplo

Conexión del SpinButton a una tarjeta de datos de formulario de edición

1. Desbloquear la tarjeta de datos
2. Ocultar el control predeterminado para el campo
3. Agregar SpinButton en la tarjeta de datos
4. Actualice la propiedad Update de la tarjeta de datos para hacer referencia a la propiedad de salida SpinButton.Value

Limitaciones

Este componente de código solo se puede usar en aplicaciones de lienzo y páginas personalizadas.