Control Entrada de texto en Power Apps
Un cuadro en el que el usuario puede escribir texto, números y otros datos.
Descripción
El usuario puede especificar datos escribiendo en un control Entrada de texto. Dependiendo de cómo configure la aplicación, puede que esos datos se agreguen a un origen de datos, usado para calcular un valor temporal, o que se incorporen de alguna otra manera.
Propiedades clave
Default: el valor inicial de un control antes de que lo cambie el usuario.
Text: texto que aparece en un control o que el usuario escribe en un control.
Propiedades adicionales
AccessibleLabel: etiqueta para lectores de pantalla.
Align: ubicación del texto respecto al centro horizontal de su control.
BorderColor: el color del borde de un control.
BorderStyle: si el borde del control es Solid, Dashed, Dotted o None.
BorderThickness: el grosor del borde de un control.
Clear: indica si un control Entrada de texto muestra una "X" sobre la que el usuario puede pulsar o hacer clic para borrar el contenido de ese control. Solo funciona en modo SingleLine.
Color: el color del texto en un control.
DelayOutput: cuando se establece en true, la entrada del usuario se registra después de un retraso de medio segundo. Resulta útil para retrasar operaciones costosas hasta que el usuario completa la entrada de texto (es decir, para el filtrado cuando la entrada se utiliza en otras fórmulas).
DisplayMode: indica si el control permite entradas de usuario (Editar), solo muestra datos (Ver) o si está deshabilitado (Deshabilitado).
DisabledBorderColor: el color del borde de un control si la propiedad DisplayMode del control está establecida en Deshabilitado.
DisabledColor: el color del texto en un control si su propiedad DisplayMode está establecida en Deshabilitado.
DisabledFill: el color de fondo de un control si su propiedad DisplayMode está establecida en Deshabilitado.
EnableSpellCheck: indica si un control de entrada de texto debe usar la función de corrección ortográfica del navegador. Power Apps para Windows no es compatible con esta propiedad.
Fill: el color de fondo de un control.
FocusedBorderColor: el color del borde de un control cuando el control recibe el foco.
FocusedBorderThickness: el grosor del borde de un control cuando el control recibe el foco.
Font: el nombre de la familia de fuentes en la que aparece el texto.
FontWeight: el peso del texto en un control: Bold, Semibold, Normal o Lighter.
Format: indica si se han restringido las entradas de usuario a solo números o a cualquier tipo de texto. Cuando se establece en Número, solo se pueden ingresar dígitos y ciertos símbolos numéricos. Los símbolos y formatos admitidos dependen del idioma del navegador y no se pueden configurar en controles individuales.
Height: la distancia entre los bordes superior e inferior de un control.
HintText: texto de color gris claro que aparece en un control Entrada de texto si está vacío.
HoverBorderColor: el color del borde de un control cuando el usuario mantiene el puntero del ratón sobre ese control.
HoverColor: el color del texto de un control cuando el usuario mantiene el puntero del ratón sobre él.
HoverFill: el color de fondo de un control cuando el usuario mantiene el puntero del ratón sobre él.
Italic: indica si el texto de un control está en cursiva.
LineHeight: distancia entre, por ejemplo, líneas de texto o elementos de una lista.
MaxLength: el número de caracteres que el usuario puede escribir en un control Entrada de texto.
Mode: el control se encuentra en modo SingleLine, MultiLine o Password.
OnChange: acciones para llevar a cabo cuando el usuario cambia el valor de un control (por ejemplo, mediante el ajuste de un control deslizante).
OnSelect: acciones para llevar a cabo cuando el usuario toca o hace clic en un control.
PaddingBottom: distancia entre el texto de un control y el borde inferior de ese control.
PaddingLeft: distancia entre el texto de un control y el borde izquierdo de ese control.
PaddingRight: distancia entre el texto de un control y el borde derecho de ese control.
PaddingTop: distancia entre el texto de un control y el borde superior de ese control.
PressedBorderColor: el color de un borde del control cuando el usuario toca o hace clic en ese control.
PressedColor: el color de texto de un control cuando el usuario toca o hace clic en ese control.
PressedFill: el color de fondo de un control cuando el usuario toca o hace clic en ese control.
RadiusBottomLeft: el grado al que se redondea la esquina inferior izquierda de un control.
RadiusBottomRight: el grado al que se redondea la esquina inferior derecha de un control.
RadiusTopLeft: el grado al que se redondea la esquina superior izquierda de un control.
RadiusTopRight: el grado al que se redondea la esquina superior derecha de un control.
Reset: indica si un control vuelve a su valor predeterminado.
Size: tamaño de la fuente del texto que aparece en un control.
Strikethrough: indica si aparece una línea sobre el texto de un control.
TabIndex: orden de navegación del teclado en relación con otros controles.
Tooltip: texto explicativo que aparece cuando el usuario mantiene el mouse sobre un control.
Underline: indica si aparece una línea debajo del texto de un control.
VirtualKeyboardMode - Tipo de teclado virtual, de texto o numérico, que aparece en la pantalla táctil de un usuario de la aplicación. La propiedad Format determina el valor predeterminado. El soporte del dispositivo varía. Los dispositivos que ejecutan iOS deben tener al menos la versión 12.2. La versión recomendada de Android es 9.0, y las capacidades de los teclados numéricos varían para dispositivos Android. Windows 10 no es compatible con esta propiedad.
Visible: indica si un control aparece o está oculto.
Width: la distancia entre los bordes derecho e izquierdo de un control.
X: la distancia entre el borde izquierdo de un control y el borde izquierdo de su contenedor primario (la pantalla si no hay un contenedor primario).
Y: la distancia entre el borde superior de un control y el borde superior de su contenedor primario (la pantalla si no hay un contenedor primario).
Funciones relacionadas
Ejemplos
Recopilación de datos
Agregue dos controles Entrada de texto y llámelos inputFirst y inputLast.
¿No sabe cómo agregar, nombrar y configurar un control?
Agregue un botón, establezca su propiedad Text en Agregar y establezca su propiedad OnSelect en esta fórmula:
Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})¿Desea más información sobre la función Collect u otras funciones?
Agregue una galería de texto en orientación vertical, establezca su propiedad Items en Names y establezca la propiedad Text de Subtitle1 en ThisItem.FirstName.
(Opcional) En la galería de plantillas, elimine la etiqueta inferior, llamada Body1 y establezca la propiedad TemplateSize de la galería en 80.
Presione F5, escriba una cadena de texto en inputFirst y en inputLasty, a continuación, pulse o haga clic en el botón Agregar.
(opcional) Agregue más nombres a la colección y, a continuación, presione Esc para volver al área de trabajo predeterminada.
Solicitud de una contraseña
Agregue un control Entrada de texto, llámelo inputPasswordy establezca su propiedad Mode en Password.
Agregue una etiqueta y establezca su propiedad Text en esta fórmula:
If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")¿Desea más información sobre la función If u otras funciones?
Presione F5 y, a continuación, escriba P@ssw0rd en inputPassword.
Cuando acabe de escribir la contraseña, la etiqueta dejará de mostrar Acceso denegado y empezará a mostrar Acceso concedido.
Para volver al área de trabajo predeterminada, presione Esc.
(opcional) Agregue un control como, por ejemplo, una flecha, configúrelo para desplazarse a otra pantalla y que solo aparezca después de que el usuario escriba la contraseña.
(opcional) Agregue un botón, configure su propiedad Text para que muestre Iniciar sesión, agregue un temporizador y deshabilite el control Entrada de texto durante un determinado período de tiempo si el usuario escribe una contraseña incorrecta y, a continuación, pulsa o hace clic en el botón Iniciar sesión.
Instrucciones para accesibilidad
Contraste de color
- Se aplican requisitos estándar de contraste de color.
Compatibilidad con el lector de pantalla
- La propiedad AccessibleLabel debe estar presente.
Compatibilidad con el teclado
- TabIndex debe ser cero o superior para que los usuarios del teclado puedan desplazarse hasta él.
- Los indicadores de foco deben ser claramente visibles. Use FocusedBorderColor y FocusedBorderThickness para conseguirlo.
Nota
¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)
La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).