Saltar para o conteúdo principal
Versão: 19

Subformulário


Permitir a eliminação

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

Gramática JSON

NomeTipo de dadosValores possíveis
deletableInListbooleantrue, 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

NomeTipo de dadosValores possíveis
detailFormstringNome (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

NomeTipo de dadosValores possíveis
doubleClickInEmptyAreaActionstring"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

NomeTipo de dadosValores possíveis
doubleClickInRowActionstring"editSubrecord", "displaySubrecord"

Objectos suportados

Subformulário

Veja também

Duplo clique numa linha vazia


Introduzível em lista

When a list subform has this property enabled, the user can modify record data directly in the list, without having to use the associated detail form.

To do this, simply click twice on the field to be modified in order to switch it to editing mode (make sure to leave enough time between the two clicks so as not to generate a double-click).

Gramática JSON

NomeTipo de dadosValores possíveis
enterableInListbooleantrue, 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.

List subforms can be used for data entry in two ways: the user can enter data directly in the subform, or enter it in an input form. In this configuration, the form used as the subform is referred to as the List form. O formulário de entrada é designado Formulário detalhado.

Gramática JSON

NomeTipo de dadosValores possíveis
listFormstringNome (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

NomeTipo de dadosValores possíveis
tabelastringNome 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. Clicking on the list will have no effect unless the Enterable in list option is enabled. 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.
    • Clicking on the record will select it, but it does not modify the current record.
    • A Ctrl+click (Windows) or Command+click (macOS) on a record toggles its state (between selected or not). 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

NomeTipo de dadosValores possíveis
selectionModestring"multiple", "single", "none"

Objectos suportados

Subformulário