Control de galería en aplicacións de lenzo

Un control que contén outros controis e amosa un conxunto de datos.

Descripción

Un control de Galería pode mostrar varios rexistros dunha orixe de datos e cada rexistro pode conter varios tipos de datos. Por exemplo, use o control Galería para mostrar varios contactos con cada elemento mostrando información de contacto que inclúa un nome, un enderezo e un número de teléfono para cada contacto.

Cada campo de datos aparece nun control separado dentro do control Galería. E pode configurar eses controis no seu modelo. O modelo aparece como o primeiro elemento dentro da galería:

  • No bordo esquerdo dun control de Galería en orientación horizontal/de paisaxe.
  • E na parte superior do control de Galería en orientación vertical/retrato.

Os cambios que faga no modelo reflíctense ao longo do control de Galería.

Existen modelos predefinidos para amosar imaxes e texto nunha galería e unha galería para elementos de altura variable.

Limitacións

Se un usuario despraza o control da galería de Altura flexible antes de cargar todos os elementos, o elemento que está actualmente visualizándose pode ser empuxado cara abaixo e sacado da vista cando remate a carga de datos. Para evitar este problema, use un control de Galería estándar en lugar da variante Altura flexible.

Propiedades clave

Predeterminado - O elemento ou rexistro da orixe de datos a seleccionar na galería cando se inicia a aplicación.

Elementos – A orixe de datos que aparece nun control como unha galería, unha lista ou unha gráfica.

Seleccionado – O elemento seleccionado.

Propiedades adicionais

AccessibleLabel - Etiqueta da galería (non os elementos que contén) para os lectores de pantalla. Debería describir cal é a lista de elementos.

Todososelementos - Todos os elementos dunha galería, incluídos os valores adicionais de control que forman parte do modelo da galería.

BorderColor - A cor do bordo dun control.

BorderStyle - Se a fronteira dun control é Continua , A trazos , Punteada ou Ningunha.

BorderThickness - O grosor do bordo dun control.

DelayItemLoading - Atrase a carga de elementos (filas) ata despois da primeira carga da pantalla.

DisplayMode - Configura se o control permite a entrada do usuario ( Editar ), só mostra datos ( Ver ) ou está desactivado ( Desactivado ).

Enchemento: a cor de fondo dun control.

Altura - A distancia entre os bordos superior e inferior dun control.

ItemAccessibleLabel - Etiqueta de cada elemento da galería para os lectores de pantalla. Debería describir que é cada elemento.

LoadingSpinner ( Ningún , Controis ou Datos ) - Se se establece Ningún, o indicador de progreso non se amosará. Cando se establece Controis | Datos, o indicador de progreso mostraranse cando se produza un pase de renderización que dá como resultado filas baleiras visibles.

LoadingSpinnerColor - A cor de recheo do indicador de progreso de carga. Por defecto, está definido como CorDeBordo.

NavigationStep - Ata onde se despraza unha galería se a súa propiedade ShowNavigation está definida en verdadeira e o usuario selecciona unha frecha de navegación nos dous extremos da galería.

Seleccionable - Se se poden seleccionar elementos da galería. Cando está configurado en verdadeiro , os lectores de pantalla identifican a galería como unha lista seleccionable. E pode seleccionarse un elemento seleccionándoo. Cando está configurado en falso , os lectores da pantalla identifican a galería como unha lista regular e seleccionando un elemento non a selecciona.

ShowNavigation - Se unha frecha aparece en cada extremo dunha galería para que o usuario poida desprazarse polos elementos da galería seleccionando unha frecha.

ShowScrollbar - Se unha barra de desprazamento aparece cando o usuario pasa o punteiro do rato por unha galería.

TemplateFill - A cor de fondo dunha galería.

TemplatePadding - A distancia entre os elementos dunha galería.

TemplateSize - A altura do modelo para unha galería en orientación vertical/retrato. Ou o ancho do modelo para unha galería en orientación horizontal/paisaxe.

Transición - O efecto visual ( Emerxente , Empurrón ou Ningún ) cando o usuario pasa o punteiro sobre un elemento nunha galería.

Visible – Se aparece un control ou está oculto.

Ancho - A distancia entre os bordos esquerdo e dereito dun control.

WrapCount - Número de elementos mostrados por fila ou columna en función da disposición horizontal ou vertical.

X - A distancia entre o bordo esquerdo dun control e o bordo esquerdo do seu recipiente ou pantalla principal.

Y - A distancia entre o bordo superior dun control e o bordo superior do recipiente ou pantalla principal.

Filter( DataSource , Formula )

Restablecer( Control ) - Restablece o estado inicial da galería. O estado inicial inclúe o desprazamento ao primeiro elemento e a selección do primeiro elemento ou o predeterminado se está presente.

Nota

O control de Restablecemento non restablece de xeito recursivo todos os elementos secundarios da galería.

Exemplos

Mostrar e filtrar datos

Obter datos do usuario

Directrices de accesibilidade

Contraste de cor

Se fai clic en calquera parte dun elemento da galería para seleccionalo, debe haber un contraste de cor adecuado entre:

  • BorderColor e a cor fóra da galería (se hai un bordo).
  • Fill e a cor fóra da galería (se non hai un bordo).

Soporte do lector de pantalla

  • AccessibleLabel debe estar presente.

    Nota

    Os lectores da pantalla anunciarán cando os elementos da galería cambian. A AccesibleLabel tamén se menciona Isto dá contexto ao anuncio e é aínda máis importante cando hai varias galerías na mesma pantalla.

  • Cando un elemento da galería contén varios controis, use ItemAccessibleLabel para mostrar os contidos dos artigos da galería.

  • Estableza o valor de Seleccionable en verdadeiro se desexa que os usuarios seleccionen un elemento da galería. Do contrario, estableza ese valor en falso.

  • Cando un elemento da galería contén varios controis, use ItemAccessibleLabel para fornecer un resumo do contido do elemento da galería.

  • Seleccionable debería axustarse adecuadamente, dependendo de se os usuarios deben seleccionar un elemento da galería.

Compatibilidade do teclado

  • Considere establecer ShowScrollbar en verdadeiro. Na maioría dos dispositivos de pantalla táctil, a barra de desprazamento non se mostrará ata que comece o desprazamento.

  • Se ao facer clic en calquera parte dun elemento da galería debería seleccionarse, tamén debe haber un xeito para que os usuarios do teclado seleccionen o elemento da galería. Por exemplo, engadir un Button que teña a súa propiedade OnSelect establecida en Select(Parent).

    Nota

    Os controis fóra da galería non se consideran na orde de navegación do teclado dentro da galería. Os controis de TabIndex dentro dunha galería están dentro do ámbito. Consulte as propiedades de accesibilidade para obter máis información.