Control da tarxeta en Power Apps

Ofrece a experiencia de edición e visualización dun único campo dun control de Display form ou Edit form.

Descripción

Os controis Display form e Edit form actúan como contedores para amosar e ver rexistros completos. Cada recipiente pode almacenar un conxunto de controis de Tarxeta que mostran campos individuais ou proporcionan unha forma de actualizar eses campos. Cada tarxeta ten unha propiedade DataField que especifica en que campo do rexistro traballa.

As tarxetas predefinidas defínense para diferentes tipos de datos e experiencias de usuario. Por exemplo, pode haber unha tarxeta para editar un campo de número cun control de Text input , que é ideal para usar co teclado. Outra tarxeta pode admitir a edición dun número usando un control de Slider no seu lugar. Co control de formulario seleccionado, no panel dereito pode seleccionar facilmente unha tarxeta baseada nun campo.

As tarxetas en si conteñen controis. Os controis dunha tarxeta compoñen a experiencia para amosar e editar un único campo. Por exemplo, unha tarxeta de número pode estar composta por un control de Label para indicar o nome de visualización do campo e un control de Text input para proporcionar un editor para o valor do campo. A tarxeta tamén pode ter un control de Label que mostra os erros de validación que se producen e un control de Label para o asterisco común para indicar que un campo é obrigatorio.

Pode personalizar os controis dunha tarxeta predefinida cambiando o seu tamaño, movéndoa, ocultándoa, engadíndolle controis e facendo outros cambios. Tamén pode comezar cunha tarxeta completamente en branco, unha "tarxeta personalizada", á que engadir controis dende cero.

As tarxetas predefinidas están bloqueadas por defecto. Nunha tarxeta bloqueada, só pode modificar algunhas propiedades da tarxeta ou os controis da tarxeta e non pode eliminar unha tarxeta bloqueada. Pode amosar o bloqueo da tarxeta e desbloqueala no separador Vista da vista Avanzada. Se unha propiedade está bloqueada e non se pode modificar, aparecerá cunha icona de cadeado xunto ao seu nome. Desbloquear unha tarxeta é unha actividade avanzada e debe facerse con coidado, xa que a xeración automática de fórmulas xa non se producirá para a tarxeta e non poderá volver bloquear unha tarxeta.

Dentro do contedor do formulario, o rexistro ThisItem está dispoñible e contén todos os campos do rexistro. Por exemplo, a propiedade Default da tarxeta está definida frecuentemente en ThisItem. FieldName.

Pode usar a referencia Principal para configurar un control para facer referencia ás propiedades dunha tarxeta. Por exemplo, un control debería empregar Parent.Default para ler o estado inicial do campo desde a orixe de datos. Ao empregar Principal en vez de acceder directamente á información que desexa, a tarxeta está mellor encapsulada e pode cambiala a outro campo sen romper as fórmulas internas.

Consulte Comprender as tarxetas de datos para obter exemplos de como personalizar, desbloquear e crear tarxetas.

Propiedades clave

DataField - O nome do campo dentro dun rexistro que esta tarxeta mostra e edita.

  • Especifique o nome como unha única cadea estática que está incluída entre comiñas dobres (por exemplo, "Nome" ), non unha fórmula.
  • Desvincule unha tarxeta configurando a súa propiedade DataField en branco. As propiedades Valid e Update ignóranse para as tarxetas non vinculadas.

Predeterminado : O valor inicial dun control antes de que o usuario o cambie.

  • Para cada control dunha tarxeta, configure esta propiedade en Parent.Default para facer referencia ao valor predeterminado do campo segundo a orixe de datos. Por exemplo, estableza a propiedade Default dun cursor da barra de desprazamento en Parent.Default para asegurarse de que o usuario comece cun valor xenérico para ese cursor da barra de desprazamento.

DisplayMode - Os valores poden ser Editar, ver ou Desactivado. Configura se o control dentro da tarxeta permite a entrada do usuario ( Editar ), só mostra datos ( Ver ) ou está desactivado ( Desactivado ).

  • Permite que se use unha única tarxeta nos formularios de edición e visualización, configurando esta propiedade, que está ligada ao comportamento do formulario por defecto.
  • No modo Ver , os controis secundarios como Text input , Drop down , Date Picker só mostrarán o valor do texto e non mostrarán ningún elemento ou decoración interactivo.

DisplayName - O nome fácil de lembrar para un campo dunha orixe de datos.

  • A función DataSourceInfo fornece estes metadatos desde a orixe de datos.
  • Os controis da tarxeta deben usar Parent.DisplayName para facer referencia ao nome do campo.

Erro - A mensaxe de erro fácil de usar para mostrar neste campo cando falla a validación.

  • Esta propiedade establécese cando se chama a SubmitForm.
  • A mensaxe describe problemas de validación baseados nos metadatos da orixe de datos e comprobando a propiedade Required da tarxeta.

Required - Se unha tarxeta, que edita o campo dunha orixe de datos, debe conter un valor.

  • A función DataSourceInfo fornece os metadatos requiridos desde a orixe de datos.
  • Os controis da tarxeta deben usar Parent.Required para determinar se o campo da tarxeta é obrigatorio.

Actualizar - O valor para volver escribir na orixe de datos dun campo.

  • Use a fórmula desta propiedade para obter os valores dos controis de edición da tarxeta para escribir de novo na orixe de datos. Por exemplo, estableza unha tarxeta Update dunha tarxeta en Slider.Value para actualizar a orixe de datos cun valor do cursor da barra de desprazamento desa tarxeta.

Largura : distancia entre os bordos esquerdo e dereito dun control.

WidthFit - Se un control crece automaticamente horizontalmente para cubrir un espazo baleiro dun control de contedores como un control de Edit form. Se varias tarxetas teñen esta propiedade establecida en verdadeiro , o espazo divídese entre elas. Para obter máis información, consulte Comprender o desaño do formulario de datos.

Propiedades adicionais

BorderColor : cor do bordo dun control.

BorderStyle : se un bordo dun control é Sólido , A trazos , Punteado ou Ningún.

BorderThickness : grosor do bordo dun control.

Enchemento : a cor de fondo dun control.

Altura : distancia entre os bordos superior e inferior dun control.

Válido - Se unha Tarxeta ou un control de Edit form contén entradas válidas, listas para ser enviadas á orixe de datos.

Visible : se aparece un control ou está oculto.

X : A distancia entre o bordo esquerdo dun control e o bordo esquerdo do seu contedor principal (pantalla, se non hai ningún contedor principal). Para un control de Card nun contedor que ten varias columnas, esta propiedade determina a columna na que aparece a tarxeta.

Y : A distancia entre o bordo superior dun control e o bordo superior do contedor principal (pantalla, se non hai ningún contedor principal). Para un control de Card nun contedor que ten varias filas, esta propiedade determina a fila na que aparece a tarxeta.

Exemplos

Consulte Comprender as tarxetas de datos e Comprender o deseño do formulario de datos para obter exemplos.

Directrices de accesibilidade

Contraste de cor

Debe haber un contraste de cor adecuado entre:

  • Recheo e calquera control secundario. Por exemplo, se unha tarxeta contén unha Label e a etiqueta ten un recheo transparente, o Recheo da tarxeta converterase de xeito efectivo na cor de fondo da etiqueta. Así, debería haber un contraste adecuado entre o Recheo a tarxeta e a Cor da etiqueta.

Soporte do lector de pantalla

  • DisplayName debe estar presente.