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 Controle deslizante. Com o controle Formulário selecionado, você pode, no painel direito, selecionar facilmente um cartão com base em um campo.

Os 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 do cartão ou os controles no cartão, 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 bloqueio ao lado do 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 para ThisItem.FieldName.

Você pode usar a referência Parent para configurar um controle que consulta as 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.

Propriedades-chave

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 blank. 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.

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.

Propriedades adicionais

BorderColor – a cor da borda do controle.

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

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.

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

X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (tela, se não houver contêiner pai).

Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (tela, se não houver contêiner pai).

Exemplos

Consulte Entender os cartões de dados para obter exemplos.