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

    This property is the name of the form itself and is used to refer to the form by name using the 4D language. The form name must comply with the rules specified for identifiers in 4D.

    Gramática JSON

    The form name is defined by the name of the folder that contains the form.4Dform file. See project architecture for more information.


    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
    inheritedFormstringName of table or project form OR a POSIX path to a .json file describing the form OR an object describing the form

    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.

    Set to \<None> in the Property List (or " " in JSON) to inherited from a project form.

    Gramática JSON

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

    Publicado como subformulário

    For a component form to be selected as a subform in a host application, it must have been explicitly shared. When this property is selected, the form will be published in the host application.

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

    This option does not take into account objects generated using the OBJECT DUPLICATE command. In order for a user to recover their environment when using this command, the developer must repeat the sequence of creation, definition and positioning of the objects.

    When this option is selected, the Save Value option is available for certain objects.

    Gramática JSON

    NomeTipo de dadosValores possíveis
    memorizeGeometrybooleantrue, false

    Veja também

    Guardar valor


    Título da janela

    The window title is used when the form is opened using the Open form window and Open window 4D commands in Application environment. O título da janela aparece na barra de título da janela.

    You can use dynamic references to set the window titles for forms, i.e.:

    • Uma referência XLIFF padrão armazenada na pasta Resources.
    • A table or field label: The syntax to apply is <?[TableNum]FieldNum> or <?[TableName]FieldName>.
    • A variable or a field: The syntax to apply is \&#060;VariableName&#062; or &#060;[TableName]FieldName&#062;. The current value of the field or variable will be displayed in the window title.

    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