Controle Cartão no Power Apps

Oferece uma experiência de exibição e edição para um único campo do controle Exibir formulário ou Editar formulário.

Descrição

Os controles Exibir formulário e Editar formulário agem como contêineres para exibir registros inteiros. Cada contêiner pode armazenar um conjunto de controles Cartão 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 funciona.

Os cartões predefinidos são configurados 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 Entrada de texto, que é ideal para uso com teclado. Outro cartão pode oferecer suporte à edição de um número com 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 viabilizam a experiência de exibição e edição de um único campo. Por exemplo, um cartão numérico pode consistir em um controle Rótulo para fornecer o nome de exibição do campo e em um controle Entrada de texto para fornecer um editor ao valor do campo. O cartão também pode ter um controle Rótulo que mostra os erros de validação ocorridos e um controle Rótulo para o asterisco que indica que um campo é obrigató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. Também é possível começar com um cartão inteiramente em branco, um "cartão personalizado", ao qual você adiciona controles do zero.

Os cartões predefinidos estão bloqueados por padrão. Em um cartão bloqueado, você pode modificar apenas determinadas propriedades dele ou os controles nele, mas não pode excluir um cartão bloqueado. Você pode mostrar o bloqueio do cartão e desbloqueá-lo na guia Exibição da exibição Avançado. Se uma propriedade estiver bloqueada e não puder ser modificada, ela será exibida com um ícone de cadeado ao lado de seu nome. Desbloquear um cartão é uma atividade avançada e deve ser feita com cuidado, porque a geração automática da fórmula não ocorrerá mais para o cartão, e você não poderá bloquear um cartão novamente.

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 está definida como ThisItem.FieldName.

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

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

Principais propriedades

DataField – o nome do campo no registro em que esse cartão permite exibições e edições.

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

Default – o valor inicial de um controle antes de ele ser alterado pelo usuário.

• Para cada controle em um cartão, defina essa propriedade como Parent.Default para consultar o 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 Edição, Exibição ou Desabilitado. Configura se o controle dentro do cartão permite entrada do usuário (Edição), apenas exibe dados (Exibição) ou está desabilitado (Desabilitado).

• Permite que um único cartão seja usado em formulários de edição e exibição por meio da configuração dessa propriedade, que é vinculada a um comportamento do Formulário por padrão.
• No modo Exibição, controles filho como Entrada de texto, Lista suspensa e Seletor de data só exibirão o valor de texto e não renderizarão nenhum elemento interativo nem decoração.

DisplayName – o nome de usuário amigável para um campo da fonte de dados.

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

Error – a mensagem de erro amigável ao usuário que é exibida para esse campo quando a validação falhar.

• Essa propriedade é definida quando a função SubmitForm é chamada.
• 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.

Required – se um cartão, que está editando o campo de uma fonte de dados, deve conter um valor.

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

Update – o valor para fazer write-back para um campo da fonte de dados.

• Use a fórmula dessa propriedade para obter os valores dos controles de edição do cartão para fazer write-back 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.

Width – a distância entre as bordas esquerda e direita de um controle.

WidthFit – indica se um controle cresce na horizontal automaticamente para preencher espaços vazios em um controle Contêiner, como o controle Editar formulário. Se diversos cartões tiverem essa propriedade definida como true, o espaço será dividido entre eles. Para obter mais informações, consulte Entender o layout de formulário de dados.

Propriedades adicionais

BorderColor – a cor da borda do controle.

BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – a espessura da borda do controle.

Fill – a cor da tela de fundo de um controle.

Height – a distância entre a parte superior do controle e as bordas inferiores.

Valid – se um controle Cartão ou Editar formulário contém entradas válidas prontas para serem enviadas à fonte de dados.

Visible – se um controle é exibido ou está oculto.

X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (ou a tela, se não houver contêiner pai). Para um controle Cartão em um contêiner com diversas colunas, essa propriedade determina a coluna em que o cartão aparecerá.

Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (ou a tela, se não houver contêiner pai). Para um controle Cartão em um contêiner com diversas linhas, essa propriedade determina a linha em que o cartão aparecerá.

Exemplos

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

Diretrizes de acessibilidade

Contraste de cores

É necessário haver um contraste de cores adequado entre:

• Fill e os controles filho. Por exemplo, se um cartão contém um Rótulo e o rótulo tem um preenchimento transparente, a propriedade Fill do cartão efetivamente se torna a cor da tela de fundo do rótulo. Portanto, deve haver contraste suficiente entre Fill do cartão e Color do rótulo.

Suporte ao leitor de tela

• DisplayName precisa estar presente.