Control Galería en Power Apps

Un control que contiene otros controles y muestra un conjunto de datos.

Descripción

Un control Galería puede mostrar varios registros desde un origen de datos y cada registro puede contener varios tipos de datos. Por ejemplo, use un control Galería para mostrar varios contactos y cada elemento mostrar a su vez información de contacto que incluye un nombre, una dirección y un número de teléfono para cada contacto.

Cada campo de datos aparece en un control separado dentro del control Galería. Y puede configurar esos controles en su plantilla. La plantilla aparece como el primer elemento dentro de la galería:

• En el borde izquierdo de un control Galería en orientación horizontal.
• Y encima de un control Galería en orientación vertical.

Los cambios realizados en la plantilla se reflejarán en todo el control Galería.

Hay disponibles plantillas predefinidas para mostrar imágenes y texto en una galería, así como una galería de elementos de altura variable.

Limitaciones

El control de galería presenta estas limitaciones:

1. Si un usuario desplaza el control de galería Altura flexible antes de que se carguen todos los elementos, el elemento que está actualmente a la vista puede ser empujado hacia abajo y fuera de la vista cuando finaliza la carga de datos. Para evitar este problema, use un control Galería estándar en lugar de la variante Altura flexible.
2. Los siguientes controles no son compatibles dentro de una galería:
   • Mostrar formulario
   • Editar formulario
   • Visor de PDF
   • Icono de Power BI
   • Editor de texto enriquecido
   • Scrollable screen (Fluid grid)
   • Escáner de códigos de barras web
3. Solo puedes agregar una galería dentro de otra galería.
4. El valor mínimo de TemplateSize es uno. Esto puede causar que los controles en la Galería se desvíen de sus valores de X o Y esperados, cuando no tiene en cuenta el tamaño de la plantilla.
5. Si genera una aplicación automáticamente a partir de datos, guarda la aplicación y, a continuación, vuelve a abrirla, la galería podría no mostrar datos inmediatamente. Para resolver este problema, escriba al menos un carácter en el cuadro de búsqueda y, a continuación, elimine el texto que ha escrito. La galería mostrará los datos según lo previsto.
6. Si una galería incluye un control ComboBox, DatePicker, Slider o Toggle con una regla que aplica un parche al mismo origen de datos o colección que la galería, puede generar un rendimiento inesperado o reducido. OnChange Esto se debe a que una regla que parchea el origen de datos de la galería puede crear un ciclo interminable de parches y recargas. OnChange Para evitar este problema, es aconsejable no utilizar reglas cuando estos controles se colocan dentro de una galería. OnChange

Propiedades importantes

Default: el elemento o registro del origen de datos que se va a seleccionar en la galería al iniciarse la aplicación.

Items: origen de datos que aparece en un control como una galería, una lista o un gráfico.

Selected: el elemento seleccionado.

Propiedades adicionales

AccessibleLabel: etiqueta de la galería (no los elementos que contiene) para lectores de pantalla. Debe describir cuál es la lista de elementos.

AllItems: elementos que se cargan en la galería. Esto puede ser menor que el número real de elementos del origen de datos. Se pueden cargar más elementos cuando se desplaza la galería. AllItems también contiene controles que se usan en cada elemento de la galería.

AllItemsCount recuento de elementos que se cargan en la galería. Esto puede ser menor que el número real de elementos del origen de datos. Se pueden cargar más elementos cuando se desplaza la galería.

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.

DelayItemLoading: retraso en la carga de elementos (filas) hasta después de que la pantalla se cargue por primera vez.

DisplayMode: indica si el control permite entradas de usuario (Editar), solo muestra datos (Ver) o si está deshabilitado (Deshabilitado).

Fill: el color de fondo de un control.

Height: la distancia entre los bordes superior e inferior de un control.

ItemAccessibleLabel: etiqueta de cada elemento de la galería para lectores de pantalla. Debe describir qué es cada elemento.

LoadingSpinner (Ninguno, Controles o Datos): cuando el valor es Ninguno, el indicador giratorio no se mostrará. Cuando sea Controles | Datos, el control de número se mostrará cuando se produce un pase de renderizado que da como resultado filas vacías visibles.

LoadingSpinnerColor: el color de relleno del indicador giratorio de carga. El valor predeterminado se establece en BorderColor.

NavigationStep: indica lo lejos que se desplaza una galería si su propiedad ShowNavigation está establecida en true y el usuario selecciona una flecha de navegación de cualquier extremo de esa galería.

Selectable: si se pueden seleccionar elementos de la galería. Cuando se establece en cierto, los lectores de pantalla identifican la galería como una lista seleccionable. Y selecciona un elemento seleccionándolo. Cuando está establecido en falso, los lectores de pantalla identifican la galería como una lista normal, y al seleccionar un elemento no se selecciona.

ShowNavigation: indica si aparece una flecha en cada extremo de una galería para que un usuario puede desplazarse por los elementos de la galería seleccionando una flecha.

ShowScrollbar: indica si aparecerá una barra de desplazamiento cuando el usuario mantenga el cursor sobre una galería.

TemplateFill: el color de fondo de una galería.

TemplatePadding: la distancia entre los elementos de una galería.

TemplateSize: la altura de la plantilla para una galería en orientación vertical. O el ancho de la plantilla para una galería en orientación horizontal. El tamaño mínimo es uno.

Transition: el efecto visual (Pop, Push o None) cuando el usuario mantiene el puntero sobre un elemento de la galería.

Visible: indica si un control aparece o está oculto.

Width: la distancia entre los bordes derecho e izquierdo de un control.

WrapCount: número de elementos que se muestran por fila o columna en función del diseño horizontal o vertical.

X: la distancia entre el borde izquierdo de un control y el borde izquierdo de su contenedor o pantalla principales.

Y: la distancia entre el borde superior de un control y el borde superior del contenedor o la pantalla principales.

Funciones relacionadas

Filter( DataSource, Formula )

Reset( Control ): restablece su galería a su estado inicial. El estado inicial incluye desplazarse al primer elemento y seleccionar el primer elemento o valor predeterminado si está presente.

Ejemplos

Mostrar y filtrar los datos

• Mostrar texto
• Mostrar imágenes
• Filtrar datos mediante la selección de una opción de la lista
• Filtrar datos mediante el ajuste de un control deslizante

Obtener datos del usuario

• Obtener texto
• Obtener imágenes
• Obtener fotografías
• Obtener sonidos
• Obtener dibujos

Instrucciones para accesibilidad

Contraste de color

Si la finalidad de hacer clic en cualquier parte en un elemento de la galería es seleccionarlo, debe haber un contraste de color adecuado entre:

• BorderColor y el color de fuera de la galería (si hay un borde).
• Fill y el color situado fuera de la galería (si no hay un borde).

Compatibilidad con el lector de pantalla

• La propiedad AccessibleLabel debe estar presente.

  Nota

  Los lectores de pantalla anunciarán cuándo cambian los elementos de la galería. La propiedad AccessibleLabel también se menciona. De esta forma, se proporciona contexto al anuncio y es incluso más importante cuando hay varias galerías en la misma pantalla.

• Cuando un elemento de la galería contiene múltiples controles, use ItemAccessibleLabel para mostrar el contenido de los elementos de la galería.

• Establezca el valor de Selectable en cierto si desea que los usuarios seleccionen un elemento de la galería. De lo contrario, establezca ese valor en falso.

• Cuando un elemento de la galería contiene múltiples controles, use ItemAccessibleLabel para proporcionar un resumen del contenido del elemento de la galería.

• Selectable debe establecerse adecuadamente, dependiendo de si los usuarios deben seleccionar un elemento de la galería.

Compatibilidad con el teclado

• Considere la posibilidad de establecer ShowScrollbar en true. En la mayoría de los dispositivos de pantalla táctil, la barra de desplazamiento no se muestra hasta que comienza el desplazamiento.

• Si la finalidad de hacer clic en cualquier parte en un elemento de la galería es seleccionarlo, debe haber también una forma de que los usuarios de teclado seleccionen el elemento de la galería. Por ejemplo, agregar un Botón cuya propiedad OnSelect esté establecida en Select(Parent).

  Nota

  Los controles situados fuera de la galería no se tienen en cuenta en el orden de desplazamiento por el teclado dentro de la galería. Se tienen en cuenta los controles TabIndex dentro de una galería. Consulte las propiedades de accesibilidad para obtener más información.

Consultar también

Use el indicador giratorio DelayItemLoading y Loading para mejorar el rendimiento en la Galería