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

Propriedades do formulário


Esquema de cores

A propriedade Esquema de cores só é aplicada no macOS.

Esta propriedade define o esquema de cores para o formulário. Por defeito, quando a propriedade não está definida, o valor para um esquema de cores é herdado (o formulário utiliza o esquema definido ao nível da aplicação). Isto pode ser alterado para o formulário para uma das duas opções seguintes:

  • dark - texto claro sobre um fundo escuro
  • light - texto escuro sobre um fundo claro

A defined color scheme can not be overridden by a CSS.

Gramática JSON

NomeTipo de dadosValores possíveis
colorSchemestring"dark", "light"

CSS

Esta propriedade permite-lhe carregar ficheiros CSS específicos para o formulário.

Um ficheiro CSS definido ao nível do formulário substituirá a(s) folha(s) de estilo predefinida(s). Para mais informações, consulte a página Folhas de estilo.

Gramática JSON

NomeTipo de dadosValores possíveis
csscadeia ou colecçãoCaminho(s) do(s) ficheiro(s) CSS fornecido(s) como:
  • uma cadeia de caracteres (um ficheiro para ambas plataformas)
  • uma coleção de cadeias de caracteres (uma lista de ficheiros para ambas as plataformas)
  • uma coleção de objectos {"path":string; "media": "mac" | "win"}

  • Pages

    Cada formulário é composto por, pelo menos, duas páginas:

    • uma página 0 (página de fundo)
    • uma página 1 (página principal)

    Para mais informações, consulte por favor Páginas formulário.

    Gramática JSON

    NomeTipo de dadosValores possíveis
    pagescollectionColeção de páginas (cada página é um objeto, a página 0 é o primeiro elemento)

    Nome do formulário

    Essa propriedade é o nome do próprio formulário sendo usada para fazer referência ao formulário pelo nome usando a linguagem 4D. O nome do formulário deve estar em conformidade com as regras especificadas para identificadores em 4D.

    Gramática JSON

    O nome do formulário é definido pelo nome da pasta que contém o arquivo form.4Dform. Consulte a arquitetura do projeto para obter mais informações.


    Tipo de formulário

    O tipo de formulário, ou seja, o seu destino, define as características que estarão disponíveis para o formulário. Por exemplo, os marcadores só podem ser definidos para formulários tabela lista (saída).

    Cada tabela de um banco de dados tem geralmente pelo menos duas formas de tabela. Uma para listar os registos no ecrã e a outra para visualizar um registo de cada vez (utilizada para a introdução de dados e modificações):

    • Formulário de saída - o formulário de saída ou o formulário lista apresenta uma lista de registos, com uma única linha por registo. Os resultados das consultas são apresentados num formulário de saída e os usuários podem fazer duplo clique numa linha para visualizar o formulário de entrada para esse registo.

    • Formulário de entrada - utilizado para entrada de dados. Apresenta um único registo por ecrã e, normalmente, tem botões para guardar e cancelar alterações ao registo e para navegar de registo em registo (i.e., Primeiro Registo, Último Registo, Registo Anterior, Registo Seguinte).

    Os tipos suportados dependem da categoria do formulário:

    Tipo de formulárioGramática JSONDescriçãoSuportado por
    Formulário detalhadodetailScreenUm formulário de visualização para introdução e modificação de dadosFormulários projeto - Formulários tabela
    Formulário detalhado para impressãodetailPrinterUm relatório impresso com uma página por registo, como uma faturaFormulários projeto - Formulários tabela
    Formulário listalistScreenUm formulário para listar os registos no ecrãFormularios tabla
    Formulário de lista para impressãolistPrinterUm relatório impresso que lista os registosFormularios tabla
    Nenhumno destinationUm formulário sem caraterística específicaFormulários projeto - Formulários tabela

    Gramática JSON

    NomeTipo de dadosValores possíveis
    destinationstring"detailScreen", "listScreen", "detailPrinter", "listPrinter"

    Nome do formulário herdado

    Esta propriedade designa o formulário para herdar no formulário atual.

    Para herdar de um formulário tabela, defina a tabela na propriedade Tabela de formulário herdado.

    Para remover a herança, selecione \<None> na Lista de Propriedades (ou " " em JSON).

    Gramática JSON

    NomeTipo de dadosValores possíveis
    inheritedFormstringNome do formulário da tabela ou do projeto OU um caminho POSIX para um arquivo .json que descreve o formulário OU um objeto que descreve o formulário

    Tabelas de formulário herdadas

    Esta propriedade específica a tabela da base de dados da qual para herda um formulário no formulário atual.

    Defina como \ <None> na Lista de Propriedades (ou " " em JSON) para herdar de um formulário projeto.

    Gramática JSON

    NomeTipo de dadosValores possíveis
    inheritedFormTablestring ou numbernome ou número da tabela

    Publicado como subformulário

    Para que um formulário de componente seja selecionado como um subformulário em uma aplicação host, ele deve ter sido explicitamente compartilhado. Quando esta propriedade for selecionada, o formulário será publicado na aplicação host.

    Apenas os projetos formulário podem ser especificados como subformulários publicados.

    Gramática JSON

    NomeTipo de dadosValores possíveis
    sharedbooleantrue, false

    Guardar geometria

    Quando a opção é usada, se a janela for aberta usando o comando Open form window com o parâmetro *, vários parâmetros de formulário são salvos automaticamente pelo 4D quando a janela é fechada, independentemente de como foram modificados durante a sessão:

    • a página atual,
    • a posição, tamanho e visibilidade de cada objecto de formulário (incluindo o tamanho e visibilidade das colunas da lista box).

    Esta opção não considera objetos gerados usando o comando OBJECT DUPLICATE. Para que um usuário recupere seu ambiente ao usar este comando, o desenvolvedor deve repetir a sequência de criação, definição e posicionamento dos objetos.

    Quando essa opção é selecionada, a opção Save Value fica disponível para determinados objetos.

    Gramática JSON

    NomeTipo de dadosValores possíveis
    memorizeGeometrybooleantrue, false

    Veja também

    Guardar valor


    Título da janela

    O título da janela é usado quando o formulário é aberto usando os comandos Open form window e Open window 4D no ambiente da aplicação. O título da janela aparece na barra de título da janela.

    Você pode usar referências dinâmicas para definir os títulos das janelas dos formulários, ou seja:

    • Uma referência XLIFF padrão armazenada na pasta Resources.
    • Um rótulo de tabela ou campo: a sintaxe a ser aplicada é <?[TableNum]FieldNum> ou <?[TableName]FieldName>.
    • Uma variável ou um campo: a sintaxe a ser aplicada é \ &#060;VariableName&#062; ou &#060;[TableName]FieldName&#062;. O valor atual do campo ou variável será exibido no título da janela.

    O número de caracteres para um título de janela é limitado a 31.

    Gramática JSON

    NomeTipo de dadosValores possíveis
    windowTitlestringO nome da janela como texto simples ou como referência