Control de tarxetas en Power Apps

Proporciona a experiencia de visualización e edición para un só campo dun control Mostrar formulario ou Editar formulario .

Descrición

Os controis Mostrar formulario e Editar formulario actúan como contedores para mostrar e ver rexistros enteiros. Cada contedor pode conter un conxunto de controis Card que mostran campos individuais ou proporcionan un xeito de actualizar eses campos. Cada tarxeta ten unha propiedade DataField que especifica en que campo do rexistro traballa.

As tarxetas predefinidas están definidas 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 entrada de texto , o que é xenial para usar co teclado. Outra tarxeta pode soportar a edición dun número usando un control deslizante . Co control de formulario seleccionado, pode, no panel dereito, seleccionar facilmente unha tarxeta baseada nun campo.

As propias tarxetas conteñen controis. Os controis dunha tarxeta constitúen a experiencia para mostrar e editar un só campo. Por exemplo, unha tarxeta numérica pode consistir nun control Etiqueta para proporcionar o nome de visualización do campo e un control de entrada de texto para proporcionar un editor para o valor do campo. A tarxeta tamén pode ter un control Etiqueta que mostra os erros de validación que se producen e un control Etiqueta para o asterisco común para indicar que se require un campo.

Pode personalizar os controis dunha tarxeta predefinida cambiándoa o seu tamaño, movéndoa, ocultándoa, engadindo controis a ela e facendo outros cambios. Tamén podes comezar cunha tarxeta completamente en branco, unha "tarxeta personalizada", á que engades controis desde cero.

As tarxetas predefinidas están bloqueadas por defecto. Nunha tarxeta bloqueada, só pode modificar certas propiedades da tarxeta ou os controis dentro da tarxeta, e non pode eliminar unha tarxeta bloqueada. Podes mostrar o bloqueo da tarxeta e desbloquealo na pestana Ver da vista avanzada . Se unha propiedade está bloqueada e non se pode modificar, aparece cunha icona de bloqueo xunto ao seu nome. Desbloquear unha tarxeta é unha actividade avanzada e debe facerse con coidado, porque a xeración automática de fórmulas xa non se producirá para a tarxeta e non se pode rebloquear 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 adoita establecerse en ThisItem. Nome do campo.

Pode usar a referencia Pai para configurar un control para facer referencia ás propiedades dunha tarxeta. Por exemplo, un control debe usar Parent.Default para ler o estado inicial do campo da fonte de datos. Ao usar Pai en lugar de acceder directamente á información que desexa, a tarxeta está mellor encapsulada e pode cambiala a un campo diferente sen romper as fórmulas internas.

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

Propiedades da 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á pechada entre comiñas dobres (por exemplo, "Nome"), non como unha fórmula.
• Desvincular unha tarxeta poñendo en branco a súa propiedade DataField. As propiedades Válido e Actualizar son ignoradas para as tarxetas non encadernadas.

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

• Para cada control dunha tarxeta, estableza esta propiedade en Parent.Default para referirse ao valor predeterminado do campo segundo a fonte de datos. Por exemplo, establece a propiedade Default dun deslizante en Parent.Default para asegurarse de que o usuario comeza cun valor xenérico para ese deslizante.

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

• Permite usar unha soa tarxeta tanto en formularios de edición como de visualización, configurando esta propiedade, que está ligada ao comportamento do formulario por defecto.
• No modo de vista , os controis fillos como Entrada de texto, Menú despregable, Selector de data só mostrarán o valor do texto e non renderizarán elementos interactivos ou decoracións.

DisplayName - O nome amigable para un campo nunha fonte de datos.

• A función DataSourceInfo proporciona estes metadatos da fonte de datos.
• Os controis dentro da tarxeta deben usar Parent.DisplayName para referirse ao nome do campo.

Erro: a mensaxe de erro amigable para o usuario que se mostrará para este campo cando falla a validación.

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

Obrigatorio : se unha tarxeta, editando o campo dunha fonte de datos, debe conter un valor.

• A función DataSourceInfo proporciona os metadatos necesarios da fonte de datos.
• Os controis dentro da tarxeta deben usar Parent.Required para determinar se o campo desa tarxeta é obrigatorio.

Actualización : o valor a escribir de novo na fonte de datos dun campo.

• Use a fórmula desta propiedade para extraer os valores dos controis de edición da tarxeta para escribir de novo na fonte de datos. Por exemplo, establece a propiedade Update dunha tarxeta en Slider.Value para actualizar a fonte de datos cun valor do deslizante desa tarxeta.

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

WidthFit - Se un control crece automaticamente horizontalmente para encher calquera espazo baleiro nun control de contedor, como un control de formulario de edición . Se varias tarxetas teñen esta propiedade establecida como true, o espazo divídese entre elas. Para obter máis información, consulte Comprender a disposición do formulario de datos.

Propiedades adicionais

BorderColor - A cor do bordo dun control.

BorderStyle - Se o bordo dun control é sólido, trazado, punteado ou ningún.

BorderThickness - O grosor do bordo dun control.

Recheo - A cor de fondo dun control.

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

Válido: se un control de tarxeta ou formulario de edición contén entradas válidas, listas para ser enviadas á fonte de datos.

Visible - Se un control aparece ou está oculto.

X - A distancia entre o bordo esquerdo dun control e o bordo esquerdo do seu contedor pai (pantalla se non hai contedor pai). Para un control 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 pai (pantalla se non hai contedor pai). Para un control Card nun contedor que ten varias filas, esta propiedade determina a fila na que aparece a tarxeta.

Exemplos

Vexa Comprender as tarxetas de datos e Comprender a disposición do formulario de datos para exemplos.

Directrices de accesibilidade

Contraste de cor

Debe haber un contraste de cor adecuado entre:

• Encher e calquera control infantil. Por exemplo, se unha tarxeta contén unha etiqueta e a etiqueta ten un recheo transparente, entón o recheo da tarxeta convértese efectivamente na cor de fondo da etiqueta. Polo tanto, debe haber un contraste adecuado entre o recheo da tarxeta e a cor da etiqueta.

Soporte do lector de pantalla

• O nome de visualización debe estar presente.