Controlo Cartão no Power Apps

Proporciona a experiência de visualização e edição para um único campo de um controlo Apresentar formulário ou Editar formulário.

Descrição

Os controlos Apresentar formulário e Editar formulário atuam como contentores para a apresentação e visualização de registos completos. Cada contentor pode conter um conjunto de controlos de Cartão que apresentam campos individuais ou fornecem uma forma de atualizar esses campos. Cada cartão tem uma propriedade DataField que especifica em que campo do registo funciona.

Os cartões predefinidos são definidos para diferentes tipos de dados e experiências de utilizador. Por exemplo, poderá haver um cartão para editar um campo numérico com um controlo de Introdução de texto, que é excelente para ser utilizado com o teclado. Outro cartão poderá suportar a edição de um número através da utilização de um controlo de Controlo de deslize. Com o controlo de formulário selecionado, pode, no painel da direita, selecionar facilmente um cartão com base num campo.

Os próprios cartões contêm controlos. Os controlos de um cartão compõem a experiência para apresentar e editar um único campo. Por exemplo, um cartão numérico pode ser constituído por um controlo Etiqueta para fornecer o nome a apresentar do campo e um controlo Introdução de texto para fornecer um editor para o valor do campo. O cartão também pode ter um controlo Etiqueta que mostra eventuais erros de validação que ocorrem e um controlo Etiqueta para o asterisco comum para indicar que um campo é obrigatório.

Pode personalizar os controlos de um cartão predefinido ao redimensioná-lo, movê-lo, ocultá-lo, adicionar controlos ao mesmo e fazer outras alterações. Também pode começar com um cartão totalmente em branco, um "cartão personalizado", ao qual adiciona controlos a partir do zero.

Os cartões predefinidos estão bloqueados por predefinição. Num cartão bloqueado, só pode modificar algumas propriedades do cartão ou dos controlos no cartão e não é possível eliminar um cartão bloqueado. Pode mostrar o bloqueio do cartão e desbloqueá-lo no separador Ver da vista Avançada. Se uma propriedade estiver bloqueada e não for possível modificá-la, é apresentada com um ícone de cadeado junto do respetivo nome. Desbloquear um cartão é uma atividade avançada e deve ser realizada com cuidado, porque a geração automática de fórmulas já não irá ocorrer para o cartão e não é possível voltar a bloquear um cartão.

No contentor do formulário, o registo ThisItem está disponível e contém todos os campos do registo. Por exemplo, a propriedade Default do cartão está, muitas vezes, definida como ThisItem.FieldName.

Pode utilizar a referência Parent para configurar um controlo para fazer referência às propriedades de um cartão. Por exemplo, um controlo deve utilizar Parent.Default para ler o estado inicial do campo a partir da origem de dados. Ao utilizar Parent em vez de aceder diretamente às informações que pretende, o cartão é melhor encapsulado e pode alterá-lo para um campo diferente sem quebrar as fórmulas internas.

Veja Compreender os cartões dados para obter exemplos de como personalizar, desbloquear e criar cartões.

Propriedades principais

DataField – O nome do campo num registo que este cartão apresenta e edita.

• Especifique o nome como uma cadeia estática única entre aspas (por exemplo, "Name") e não uma fórmula.
• Para desvincular um cartão, defina a respetiva propriedade DataField como blank. As propriedades Valid e Update são ignoradas para cartões desvinculados.

Default – o valor inicial de um controlo antes de ser alterado pelo utilizador.

• Para cada controlo num cartão, defina esta propriedade como Parent.Default para fazer referência ao valor predefinido do campo, de acordo com a origem de dados. Por exemplo, defina a propriedade Default de um controlo de deslize como Parent.Default para se certificar de que o utilizador começa com um valor genérico para esse controlo de deslize.

DisplayMode – os valores podem ser Editar, Visualizar ou Desativado. Configura se o controlo dentro do cartão permite a intervenção do utilizador (Editar), apenas apresenta os dados (Ver) ou está desativado (Desativado).

• Permite que um único cartão seja utilizado nos formulários de edição e visualização, ao configurar esta propriedade, que está associada ao comportamento do Formulário por predefinição.
• No modo de Visualização, os controlos subordinados, tais como Introdução de texto, Lista pendente e Seletor de datas, apenas irão apresentar o valor de texto e não irão apresentar todos os elementos interativos ou decorações.

DisplayName – O nome amigável de utilizador para um campo numa origem de dados.

• A função DataSourceInfo fornece estes metadados da origem de dados.
• Os controlos no cartão devem utilizar Parent.DisplayName para fazer referência ao nome do campo.

Error – A mensagem de erro amigável de utilizador a apresentar para este campo quando ocorre uma falha de validação.

• Esta propriedade é definida quando SubmitForm é chamada.
• A mensagem descreve problemas de validação com base nos metadados da origem de dados e na verificação da propriedade Required do cartão.

Required – Se um cartão, editando o campo de uma origem de dados, tem de conter um valor.

• A função DataSourceInfo fornece os metadados necessários da origem de dados.
• Os controlos no cartão devem utilizar Parent.Required para determinar se o campo desse cartão é necessário.

Update – O valor para efetuar um write back para a origem de dados de um campo.

• Utilize a fórmula desta propriedade para extrair os valores dos controlos de edição do cartão para efetuar um write back para a origem de dados. Por exemplo, defina a propriedade Update de um cartão como Controlo de deslize.Value para atualizar a origem de dados com um valor do controlo de deslize nesse cartão.

Width – a distância entre as margens esquerda e direita de um controlo.

WidthFit – Se um controlo aumenta automaticamente na horizontal para preencher qualquer espaço em branco de um controlo de contentor, como um controlo Editar formulário. Se vários cartões tiverem esta propriedade definida como verdadeiro, o espaço é dividido entre eles. Para obter mais informações, veja Compreender o esquema dos formulários de dados.

Propriedades adicionais

BorderColor – a cor do limite de um controlo.

BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.

BorderThickness – a espessura do limite de um controlo.

Fill – a cor de fundo de um controlo.

Height – a distância entre as margens superiores e inferiores de um controlo.

Valid – Se um controlo de Cartão ou Editar formulário contiver entradas válidas, prontas para serem submetidas para a origem de dados.

Visible – se um controlo é apresentado ou está oculto.

X – a distância entre o limite esquerdo de um controlo e o limite esquerdo do respetivo recipiente principal (do ecrã, se não existir um recipiente principal). Para um controlo Cartão num contentor que tem várias colunas, esta propriedade determina a coluna na qual o cartão é apresentado.

Y – a distância entre o limite superior de um controlo e o limite superior do recipiente principal (do ecrã, se não existir um recipiente principal). Para um controlo Cartão num contentor que tem várias linhas, esta propriedade determina a linha na qual o cartão aparece.

Exemplos

Veja Compreender os cartões dados e Compreender o esquema dos formulários de dados para obter exemplos.

Diretrizes de acessibilidade

Contraste de cor

Tem de existir contraste de cor adequado entre:

• Fill e quaisquer controlos subordinados. Por exemplo, se um cartão tiver uma Etiqueta e a etiqueta tiver um preenchimento transparente, o Fill do cartão tornar-se-á efetivamente a cor de fundo da etiqueta. Assim, deverá haver contraste adequado entre o Fill do cartão e a Color da etiqueta.

Suporte a leitor de ecrã

• DisplayName tem de estar presente.