Controlo de cartão nas Power Apps

Fornece a experiência de exibição e edição para um único campo de um formulário de exibição ou controle Editar formulário .

Description

Os controles Exibir formulário e Editar formulário atuam como contêineres para exibir e exibir registros inteiros. Cada contêiner pode conter um conjunto de controles Card que exibem campos individuais ou fornecem uma maneira de atualizar esses campos. Cada cartão tem uma propriedade DataField que especifica em qual campo do registro ele trabalha.

Os cartões predefinidos são definidos para diferentes tipos de dados e experiências do usuário. Por exemplo, pode haver um cartão para editar um campo numérico com um controle de entrada de texto , o que é ótimo para uso com o teclado. Outro cartão pode suportar a edição de um número usando um controle deslizante . Com o controle de formulário selecionado, você pode, no painel direito, selecionar facilmente um cartão com base em um campo.

Os próprios cartões contêm controles. Os controles de um cartão compõem a experiência para exibir e editar um único campo. Por exemplo, um cartão numérico pode consistir em um controle Label para fornecer o nome de exibição do campo e um controle de entrada Text para fornecer um editor para o valor do campo. O cartão também pode ter um controle Label que mostra quaisquer erros de validação que ocorrem e um controle Label para o asterisco comum para indicar que um campo é necessário.

Você pode personalizar os controles de um cartão predefinido redimensionando-o, movendo-o, ocultando-o, adicionando controles a ele e fazendo outras alterações. Você também pode começar com um cartão totalmente em branco, um "cartão personalizado", ao qual você adiciona controles do zero.

Os cartões predefinidos são bloqueados por padrão. Em um cartão bloqueado, você pode modificar apenas determinadas propriedades do cartão ou os controles dentro do cartão, e não pode excluir 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 puder ser modificada, ela aparecerá com um ícone de cadeado ao lado de seu nome. O desbloqueio de um cartão é uma atividade avançada e deve ser feito com cuidado, porque a geração automática de fórmulas não ocorrerá mais para o cartão, e você não poderá bloquear novamente um cartão.

Dentro do contêiner do formulário, o registro ThisItem está disponível e contém todos os campos do registro. Por exemplo, a propriedade Default do cartão geralmente é definida como ThisItem. Nome do Campo.

Você pode usar a referência pai para configurar um controle para fazer referência às propriedades de um cartão. Por exemplo, um controle deve usar Parent.Default para ler o estado inicial do campo da fonte de dados. Ao usar Pai em vez de acessar diretamente as informações desejadas, o cartão é melhor encapsulado e você pode alterá-lo para um campo diferente sem quebrar fórmulas internas.

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

Propriedades principais

DataField – O nome do campo dentro de um registro que este cartão exibe e edita.

• Especifique o nome como uma única cadeia de caracteres estática entre aspas duplas (por exemplo, "Nome"), não como uma fórmula.
• Desvincule um cartão definindo sua propriedade DataFieldem branco. As propriedades Valid e Update são ignoradas para cartões não acoplados.

Padrão – O valor inicial de um controle antes de ser alterado pelo usuário.

• Para cada controle em um cartão, defina essa propriedade como Parent.Default para se referir ao valor padrão do campo de acordo com a fonte de dados. Por exemplo, defina a propriedade Default de um controle deslizante como Parent.Default para garantir que o usuário comece com um valor genérico para esse controle deslizante.

DisplayMode – Os valores podem ser Edit, View ou Disabled. Configura se o controle dentro do cartão permite a entrada do usuário (Editar), exibe apenas dados (Exibir) ou está desabilitado (Desabilitado).

• Permite que um único cartão seja usado em formulários de edição e exibição, configurando essa propriedade, que está vinculada ao comportamento do formulário por padrão.
• No modo de exibição , os controles filho, como Entrada de texto, Menu suspenso, Seletor de data , exibirão apenas o valor do texto e não renderizarão nenhum elemento interativo ou decorações.

DisplayName – O nome amigável para um campo em uma fonte de dados.

• A função DataSourceInfo fornece esses metadados da fonte de dados.
• Os controles dentro da placa devem usar Parent.DisplayName para se referir ao nome do campo.

Erro – A mensagem de erro amigável a ser exibida para este campo quando a validação falhar.

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

Obrigatório – Se um cartão, editando o campo de uma fonte de dados, deve conter um valor.

• A função DataSourceInfo fornece os metadados necessários da fonte de dados.
• Os controles dentro do cartão devem usar Parent.Required para determinar se o campo do cartão é obrigatório.

Atualização – O valor para gravar novamente na fonte de dados de um campo.

• Use a fórmula desta propriedade para extrair os valores dos controles de edição do cartão para gravar de volta na fonte de dados. Por exemplo, defina a propriedade Update de um cartão como Slider.Value para atualizar a fonte de dados com um valor do controle deslizante nesse cartão.

Largura – A distância entre as bordas esquerda e direita de um controle.

WidthFit – Se um controle cresce automaticamente horizontalmente para preencher qualquer espaço vazio em um controle de contêiner, como um controle Edit form . Se vários cartões tiverem essa propriedade definida como true, o espaço será dividido entre eles. Para obter mais informações, consulte Compreender o layout do formulário de dados.

Propriedades adicionais

BorderColor – A cor da borda de um controle.

BorderStyle – Se a borda de um controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – A espessura da borda de um controle.

Preenchimento – A cor de fundo de um controlo.

Altura – A distância entre as bordas superior e inferior de um controle.

Válido – Se um controle de formulário Card ou Edit contém entradas válidas, prontas para serem enviadas à fonte de dados.

Visível – Se um controle aparece 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 controle Card em um contêiner que tem várias colunas, essa propriedade determina a coluna na qual o cartão aparece.

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 controle Card em um contêiner que tem várias linhas, essa propriedade determina a linha na qual o cartão aparece.

Examples

Consulte Compreender cartões de dados e Compreender o layout do formulário de dados para obter exemplos.

Diretrizes de acessibilidade

Contraste de cor

Deve haver um contraste de cor adequado entre:

• Preencha e qualquer controle filho. Por exemplo, se um cartão contiver uma Etiqueta e a etiqueta tiver um preenchimento transparente, então o Preenchimento do cartão torna-se efetivamente a cor de fundo da etiqueta. Assim, deve haver um contraste adequado entre o Preenchimento do cartão e a Cor do rótulo.

Suporte a leitor de ecrã

• DisplayName deve estar presente.