Função

Sub Formulário é um componente para cadastrar, editar e exibir dados dentro do componente Formulário. Ele permite navegar entre os registros, adicionar, editar e excluir o registro ativo.

Animação 1 - 

Principais propriedades

Subcomponentes

Esse componente é formado por oito subcomponentes agrupados: seis botões e uma div. Cada um possui uma função que vem configurada no componente. Para selecionar um subcomponente basta clicar no que for desejado.

Configuração

Relacionamento

Crie um exemplo para filtrar os status (Sub Formulário) de acordo com o pedido (Formulário). Para isso, é necessário configurar duas entidades (pedido e status) com o relacionamento 1 para N entre elas para criar a chave estrangeira (FK).

Figura 1 - Relacionamento 1 para N

Inserir componentes

Após adicionar o componente Formulário e configurá-lo, insira o componente Grade e configure-selecione a com a fonte de dados Status . Os campos exibidos na listagem serão apenas status e datano campo Fonte de Dados na janela de configuração. Depois vá até a aba Colunas e na coluna Listagem deixe marcado com um x apenas os campos status, data e o botão de comando. Caso não deseje utilizar a grade, adicione e configure apenas a fonte o componente Fonte de dados.

Image Added

Figura 2 - Inserindo a grade

Em seguida, arraste o componente Sub Formulário para a área de edição abaixo da grade (Figura 3).

Figura 3 - Inserindo componente Sub Formulário

Vincular fonte de dados

Após configurar a fonte de dados, selecione o componente Sub Formulário e, na aba de Propriedades, vincule a fonte no campo Fonte de dados (Figura 4).

Figura 4 - Vinculando fonte de dados ao componente

Mestre detalhe

Na fonte de dados do Sub Formulário, vá até a aba de Propriedades e adicione uma ligação no campo Mestre Detalhe. Clique em "..." (destaque 1 da Figura 56), depois clique em Adicionar Ligação (2) e selecione no Campo detalhe a chave estrangeira criada no relacionamento entre fontes pedido igual ao id da fonte de dados Pedido.active.id do componente Formulário. Exemplo: pedido = Expressão Pedido.active.id.

Figura 5 - Configurando mestre detalhe

Adicionar campo

Em seguida, arraste um componente à div do formulário, verificando se as arestas da div do componente sub formulário estão tracejadas , (Figura 6) e solte-o. Para adicionar outro componente, arraste-o para a área de edição abaixo do campo recém-adicionado.

Image Added

Figura 6 - Adicionando campo ao sub formulário

Configurar campo

Para que o item seja salvo, é necessário vincular o componente com um campo da fonte de dados. Então, selecione no componente (destaque 1 da Figura 7) e, na aba Propriedades, abra a lista suspensa do campo Valor (2Figura 7) e escolha em qual dos campos da fonte de dados  dados será salvo. 

Obs.: Deve-se fazer esse procedimento para todos os componentes adicionados ao formulário.

Figura 7 - Configurando valor do componente

Por fim, alguns componentes permitem adicionar a propriedade apenas leitura para que não seja possível escrever no item quando não estiver em modo de inserção ou edição. No caso de um componente Entrada de texto, selecione-o e desagrupe-o. Selecione somente a tag input (destaque 1 da Figura 8), clique em Exibir mais e adicione o conteúdo !datasource.editing && !datasource.inserting na propriedade Apenas leitura.

Obs.: Repita esse procedimento para todos os campos adicionados no formulário.

Figura 8 - Configurando propriedade apenas leitura