Control Agregar imagen en aplicaciones de lienzo
Toma una fotografía o carga imágenes desde el dispositivo local.
Descripción
Con este control los usuarios pueden tomar fotografías o cargar archivos de imagen desde su dispositivo y actualizar el origen de datos con este contenido. En un dispositivo móvil se presenta al usuario el cuadro de diálogo de elección del dispositivo para que elija entre tomar una foto o seleccionar una ya disponible.
Este control es un control agrupado que contiene dos controles: un control Imagen y un control Botón Agregar imagen. El control Imagen muestra la imagen cargada o un marcador de posición si no se ha cargado ninguna imagen. El control Botón Agregar imagen le solicita una imagen para cargar.
Consulte la referencia del control Imagen para conocer las propiedades de Imagen.
Limitaciones
El control imagen presenta estas limitaciones:
- Al usar el control Add Picture en iOS, las imágenes importadas mediante la cámara o la galería no contienen metadatos como orientación, información de ubicación o configuración de cámara.
Propiedades del botón Agregar imagen
AccessibleLabel: etiqueta para lectores de pantalla. Debe describir la finalidad de agregar una imagen.
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.
ChangePictureText: texto que aparece en el botón cuando se ha cargado una imagen.
Color: el color del texto en un control.
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.
DisplayMode: indica si el control permite entradas de usuario (Editar), solo muestra datos (Ver) o si está deshabilitado (Deshabilitado).
Error: si hay un problema al cargar una imagen, esta propiedad contendrá una cadena de error apropiada.
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.
Height: la distancia entre los bordes superior e inferior de un control.
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.
Media: un identificador de la secuencia que reproduce un control de audio o de vídeo.
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.
Padding: la distancia entre el texto de un botón Exportar o Importar y los bordes de ese botón.
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.
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.
Text: texto que aparece en el botón cuando no se ha cargado una imagen.
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.
UseMobileCamera: indica si se usará una cámara móvil directamente, cuando esté disponible. Para dispositivos Android, esta propiedad requiere el ajuste experimental Captura de medios mejorada activado.
VerticalAlign: ubicación del texto en un control respecto al centro vertical de ese control.
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
Patch( DataSource, BaseRecord, ChangeRecord )
Ejemplos
Agregar imágenes a un control Galería de imágenes
Agregue un control Agregar imagen y, a continuación, haga clic en él tres veces.
¿No sabe cómo agregar, nombrar y configurar un control?
En el cuadro de diálogo Abrir, pulse o haga clic en un archivo de imagen y luego pulse o haga clic en Abrir.
Agregue un control Botón, muévalo al control Agregar imagen y establezca la propiedad OnSelect del control Botón en esta fórmula:
Collect(MyPix, AddMediaButton1.Media)¿Desea más información sobre la función Collect u otras funciones?
Agregue un control Galería vertical y establezca su propiedad Items en MyPix.
Selecciona el control Imagen en la galería y configure su propiedad Imagen en ThisItem.Value.
Presione F5 y pulse o haga clic en el control Botón.
La imagen del control Agregar imagen aparece en el control Galería vertical. Si la imagen no tiene la misma relación de aspecto que el control Imagen del control Galería vertical, establezca la propiedad ImagePosition del control Imagen en Ajustar.
Pulse o haga clic en el control Agregar imagen, pulse o haga clic en Abrir y luego pulse o haga clic en el control Botón que agregó.
La segunda imagen aparece en el control Galería de imágenes.
(opcional) Repita el paso anterior una o más veces y, a continuación, presione Esc para volver al área de trabajo predeterminada.
Use la función SaveData para guardar las imágenes localmente o la función Patch para actualizar el origen de datos.
Instrucciones para accesibilidad
Se aplican las mismas directrices para Botón e Imagen. Además, tenga en cuenta lo siguiente:
Contraste de color
- El control Botón Agregar imagen debe tener el contraste adecuado entre su texto y el fondo. Dado que la imagen cargada puede tener diversos colores, use una propiedad Fill opaca en el Botón Agregar imagen garantizar un contraste uniforme.
Compatibilidad con el lector de pantalla
- Botón Agregar imagen debe tener las propiedades Text y ChangePictureText que soliciten al usuario que agregue o cambie una imagen.
Compatibilidad con el teclado
- Botón Agregar imagen debe tener la propiedad TabIndex igual a cero o superior para que los usuarios del teclado puedan desplazarse hasta él.
- Botón Agregar imagen debe tener claramente visibles los indicadores de enfoque. 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).