Controle de cartão no Power Apps

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

Description

O formulário de exibição e os controles de formulário de edição atuam como contêineres para exibir e exibir registros inteiros. Cada contêiner pode conter um conjunto de controles de 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 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 dar suporte à 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 de texto para fornecer um editor para o valor do campo. O cartão também pode ter um controle Label que mostra os erros de validação que ocorrem e um controle de rótulo 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, escondendo-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 dos controles dentro do cartão e não pode excluir um cartão bloqueado. Você pode mostrar o bloqueio do cartão e desbloqueá-lo na guia Exibição do modo de exibição Avançado . Se uma propriedade estiver bloqueada e não puder ser modificada, ela será exibida com um ícone de bloqueio ao lado de seu nome. Desbloquear um cartão é uma atividade avançada e deve ser feito com cuidado, pois a geração automática de fórmulas não ocorrerá mais para o cartão e você não pode recadear 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 Padrão do cartão geralmente é definida como ThisItem. FieldName.

Você pode usar a referência pai para configurar um controle para referenciar as 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 Noções básicas sobre cartões de dados para obter exemplos de como personalizar, desbloquear e criar cartões.

Principais propriedades

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 uma fórmula.
• Desvinme um cartão definindo sua propriedade DataFieldem branco. As propriedades Valid e Update são ignoradas para cartões não associados.

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 Padrão 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 Editar, Exibir ou Desabilitado. Configura se o controle dentro do cartão permite a entrada do usuário (Editar), exibe apenas dados (Exibição) 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 Modo de Exibição, controles filho, como entrada de Texto, Suspenso, Seletor de Data exibirão apenas o valor do texto e não renderizarão elementos interativos ou decorações.

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

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

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

• Essa propriedade é definida quando SubmitForm é chamado.
• A mensagem descreve problemas de validação com base nos metadados da fonte de dados e verificando a propriedade necessária 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 desse cartão é necessário.

Atualização – o valor a ser gravado novamente na fonte de dados de um campo.

• Use a fórmula dessa propriedade para extrair os valores dos controles de edição do cartão para gravar novamente 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 horizontalmente automaticamente para preencher qualquer espaço vazio em um controle de contêiner, como um controle editar formulário . Se vários cartões tiverem essa propriedade definida como true, o espaço será dividido entre eles. Para obter mais informações, consulte Entender o layout do formulário de dados.

Propriedades adicionais

BorderColor – A cor da borda de um controle.

BorderStyle – se a borda de um controle é Solid, Dashed, Dotted ou None.

BorderThickness – A espessura da borda de um controle.

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

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

Válido – se um controle de formulário de cartão ou de edição contém entradas válidas, prontos para serem enviados à fonte de dados.

Visível – se um controle aparece 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 que tem várias colunas, essa propriedade determina a coluna na qual o cartão é exibido.

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 que tem várias linhas, essa propriedade determina a linha na qual o cartão é exibido.

Exemplos

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

Diretrizes de acessibilidade

Contraste de cores

Deve haver contraste de cores adequado entre:

• Preencha e todos os controles filho. Por exemplo, se um cartão contiver um Rótulo e o rótulo tiver preenchimento transparente, o Preenchimento do cartão efetivamente se tornará a cor da tela de fundo do rótulo. Portanto, deve haver um contraste adequado entre o Preenchimento do cartão e a Cor do rótulo.

Suporte ao leitor de tela

• DisplayName deve estar presente.