Subformulário

---

Permitir a eliminação

Especifica se o utilizador pode eliminar sub-registos num subformulário lista.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
deletableInList	boolean	true, false (padrão: true)

Objectos suportados

Subformulário

---

Formulário detalhado

Esta propriedade é utilizada para declarar o formulário detalhado a utilizar no subformulário. Pode ser:

• um widget, ou seja, um subformulário de tipo página, dotado de funções específicas. In this case, the list subform and Source properties must be empty or not present.
  You can select a component form name when it is published in the component.

É possível gerar componentes fornecendo funcionalidades adicionais através de subformulários.

• o formulário detalhado para associar ao subformulário lista. O formulário detalhado pode ser utilizado para introduzir ou visualizar sub-registos. Geralmente contém mais informações do que o subformulário lista. Naturalmente, o formulário detalhado deve pertencer à mesma tabela que o subformulário. Normalmente, utiliza-se um formulário de saída como formulário lista e um formulário de entrada como formulário detalhado. Se não especificar o formulário a ser usado para a entrada de página inteira, 4D automaticamente usa o formato de entrada padrão da tabela.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
detailForm	string	Nome (string) da tabela ou formulário projeto, um caminho POSIX (string) para um arquivo .json descrevendo o formulário, ou um objeto descrevendo o formulário

Objectos suportados

Subformulário

---

Duplo clique numa linha vazia

Ação a ser executada no caso de um clique duplo em uma linha vazia de um subformulário lista. As opções abaixo estão disponíveis:

• Não fazer nada: Ignora o duplo clique.
• Adicionar registro: cria um registro no subformulário e muda para o modo edição. O registro será criado diretamente na lista se a propriedade [Entrável em lista] estiver ativada. Otherwise, it will be created in page mode, in the detail form associated with the subform.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
doubleClickInEmptyAreaAction	string	"addSubrecord" ou "" para não fazer nada

Objectos suportados

Subformulário

Veja também

Duplo clique em linha

---

Duplo clique em linha

Subformulário lista

Define a ação a ser executada quando um usuário clica duas vezes em uma linha no subformulário lista. As opções disponíveis são:

• Não fazer nada (padrão): clicar duas vezes em uma linha não aciona nenhuma ação automática.
• Editar registro: clicar duas vezes em uma linha exibe o registro correspondente no formulário de detalhes definido para o subformulário lista. O registo é aberto em modo de leitura-escrita para poder ser modificado.
• Exibir registro: idêntico à ação anterior, exceto pelo fato de que o registro é aberto no modo somente leitura, de modo que não pode ser modificado.

Independentemente da ação selecionada/escolhida, o evento de formulário On Double clicked é gerado.

Para as duas últimas ações, o evento do formulário On Open Detail também é gerado. On Close Detail é gerado quando um registro exibido no formulário detalhado associado à list box está prestes a ser fechado (independentemente de o registro ter sido modificado ou não).

Gramática JSON

Nome	Tipo de dados	Valores possíveis
doubleClickInRowAction	string	"editSubrecord", "displaySubrecord"

Objectos suportados

Subformulário

Veja também

Duplo clique numa linha vazia

---

Introduzível em lista

Quando um subformulário de lista tem essa propriedade ativada, o usuário pode modificar os dados do registro diretamente na lista, sem precisar usar o formulário detalhado associado.

Para fazer isso, basta clicar duas vezes no campo a ser modificado para alterná-lo para o modo de edição (certifique-se de deixar tempo suficiente entre os dois cliques para não gerar um clique duplo).

Gramática JSON

Nome	Tipo de dados	Valores possíveis
enterableInList	boolean	true, false

Objectos suportados

Subformulário

---

Formulário lista

Você usa essa propriedade para declarar o formulário de lista a ser usado no subformulário. Um subformulário lista permite que você insira, visualize e modifique dados em outras tabelas.

Os subformulários de lista podem ser usados para entrada de dados de duas maneiras: o usuário pode inserir dados diretamente no subformulário ou inseri-los em um formulário de entrada. Nessa configuração, o formulário usado como subformulário é chamado formulário Lista. O formulário de entrada é designado Formulário detalhado.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
listForm	string	Nome (string) da tabela ou formulário projeto, um caminho POSIX (string) para um arquivo .json descrevendo o formulário, ou um objeto descrevendo o formulário

Objectos suportados

Subformulário

---

Source

Especifica a tabela a que pertence o subformulário Lista (se existir).

Gramática JSON

Nome	Tipo de dados	Valores possíveis
tabela	string	Nome da tabela 4D, ou "" se não houver tabela.

Objectos suportados

Subformulário

---

Modo seleção

Designa a opção que permite aos utilizadores selecionar linhas:

• Nenhum: as linhas não podem ser selecionadas se esse modo for escolhido. Clicar na lista não terá efeito, a menos que a opção Entrável na lista esteja ativada. As teclas de navegação só fazem a lista rolar, o evento formulário On Selection Change não é gerado.
• Simples: uma linha de cada vez pode ser selecionada neste modo. Ao clicar em uma linha, ela será selecionada. A Ctrl+click (Windows) or Command+click (macOS) on a row toggles its state (between selected or not).
  The Up and Down arrow keys select the previous/next row in the list. As outras teclas de navegação percorrem a lista. O evento formulário On Selection Change é gerado sempre que a linha atual é alterada.
• Múltiplo: várias linhas podem ser selecionadas simultaneamente neste modo.
  • Os sub-registos selecionados são devolvidos pelo comando GET HIGHLIGHTED RECORDS.
  • Clicar no registro o selecionará, mas não modificará o registro atual.
  • Ctrl+clique (Windows) ou Comando+clique (macOS) em um registro alterna seu estado (entre selecionado ou não). As teclas de seta para cima e para baixo selecionam o registo anterior/seguinte na lista. As outras teclas de navegação percorrem a lista. O evento do formulário On Selection Change é gerado sempre que o registo selecionado é alterado.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
selectionMode	string	"multiple", "single", "none"

Objectos suportados

Subformulário