Objetos
Tipo
CONFIGURAÇÃO OBRIGATÓRIA
Esta propriedade designa o tipo de objecto formulárioactivo ou inactivo.
Gramática JSON
| Nome | Tipo de dados | Valores possíveis |
|---|---|---|
| type | string | "button", "buttonGrid", "checkbox", "combo", "dropdown", "groupBox", "input", "line", "list", "listbox", "oval", "picture", "pictureButton", "picturePopup", "plugin", "progress", "radio", "rectangle", "ruler", "spinner", "splitter", "stepper", "subform", "tab", "text", "view", "webArea", "write" |
Objectos suportados
Área 4D View Pro - Área 4D Write Pro - Botão - Grade de botões - Caixa de seleção - Caixa de - Lista suspensa - Caixa de grupo - Lista hierárquica - List Box - Coluna de List Box - Rodapé List Box - Cabeçalho List Box - Botão de imagem - Menu pop-up imagem - Área de plug-in - Indicador de progresso - Botão de rádio - Spinner - Divisor - Imagem estática - Stepper - Subformulário - Controle de tabulação - Área de texto - Área da Web
Nome de objeto
Cada objeto de formulário ativo está associado a um nome de objeto. Cada nome de objeto deve ser único.
Os nomes dos objectos estão limitados a um tamanho de 255 bytes.
Ao usar a linguagem 4D, você pode se referir a um objeto de formulário ativo pelo nome do objeto (para obter mais informações sobre isso, consulte Propriedades do objeto no manual de referência da linguagem 4D).
Para obter mais informações sobre regras de nomeação para objetos de formulário, consulte a seção Identificadores.
Gramática JSON
| Nome | Tipo de dados | Valores possíveis |
|---|---|---|
| name | string | Qualquer nome permitido que não pertença a um objeto já existente |
Objectos suportados
Área 4D View Pro - Área 4D Write Pro - Botão - Grade de botões - Caixa de seleção - Caixa de - Lista suspensa - Caixa de grupo - Lista hierárquica - List Box - Coluna de List Box - Rodapé List Box - Cabeçalho List Box - Botão de imagem - Menu pop-up imagem - Área de plug-in - Indicador de progresso - Spinner - Divisor - Imagem estática - Stepper - Botão de rádio -Subformulário - Controle de tabulação - Área de texto - Área da Web
Salvar valor
Essa propriedade está disponível quando a opção Salvar geometria está marcada para o formulário.
Essa funcionalidade só é suportada por objetos que contribuam para a geometria geral do formulário. Por exemplo, esta opção está disponível para caixas de seleção porque seu valor pode ser usado para ocultar ou exibir áreas adicionais na janela.
Eis a lista de objetos cujo valor pode ser guardado:
| Object | Valor guardado |
|---|---|
| Caixa de selecção | Valor da variável associada (0, 1, 2) |
| Lista suspensa ou drop down | Número da linha seleccionada |
| Botão rádio | Valor da variável associada (1, 0, True ou False para os botões, consoante o seu tipo) |
| Controle de abas | Número da aba selecionada |
Gramática JSON
| Nome | Tipo de dados | Valores possíveis |
|---|---|---|
| memorizeValue | boolean | true, false |
Objectos suportados
Caixa de verificação - Lista pendente - Botão de rádio - Controlo de separadores
Variável ou expressão
Veja também Expression para colunas de list box de tipo seleção e coleção.
Esta propriedade especifica a fonte dos dados. Cada objeto de formulário ativo está associado a um nome de objeto e a um nome de variável. O nome da variável pode diferir do nome do objeto. No mesmo formulário, você pode usar a mesma variável várias vezes, mas cada nome de objeto deve ser exclusivo.
O tamanho do nome da variável é limitado a 31 bytes. Consulte a seção Identificadores para obter mais informações sobre regras de nomenclatura.
As variáveis de objeto do formulário permitem controlar e monitorar os objetos. Por exemplo, quando um botão é clicado, sua variável é definida como 1; em todos os outros momentos, ela é 0. A expressão associada a um indicador de progresso permite que você leia e altere a configuração atual.
As variáveis ou expressões podem ser digitáveis ou não digitáveis e podem receber dados do tipo Texto, Inteiro, Numérico, Data, Hora, Imagem, Booleano ou Objeto.
Gramática JSON
| Nome | Tipo de dados | Valores possíveis |
|---|---|---|
| dataSource | string ou array de strings |
Expressões
Você pode usar uma expressão como fonte de dados para um objeto. Qualquer expressão 4D válida é permitida: expressão simples, propriedade do objeto, fórmula, função 4D, nome do método do projeto ou campo usando a sintaxe padrão [Table]campo. A expressão é avaliada quando o formulário é executado e reavaliado para cada evento de formulário. Observe que as expressões podem ser atribuíveis ou não atribuíveis.
Se o valor inserido corresponde a um nome de variável e a um nome de método, 4D considera que você está indicando o método.
Variáveis dinâmicas
Você pode deixar que 4D crie variáveis associadas a seus objetos de formulário (botões, variáveis inseríveis, caixas de seleção, etc.) dinamicamente e de acordo com suas necessidades. Para isso, basta deixar a propriedade "Variable or Expression" (ou o campo dataSource JSON) em branco.
Quando uma variável não é nomeada, quando o formulário é carregado, 4D cria uma nova variável para o objeto, com um nome calculado que é único no espaço das variáveis de processo do intérprete (o que significa que esse mecanismo pode ser usado mesmo no modo compilado). Esta variável temporária será destruída quando o formulário for fechado. Para que este princípio funcione em modo compilado, é imperativo que as variáveis dinâmicas sejam explicitamente tipadas. Há duas formas de o fazer:
- Pode definir o tipo utilizando a propriedade Tipo de expressão.
- É possível utilizar um código de inicialização específico quando o formulário é carregado, que utiliza, por exemplo, o comando
VARIABLE TO VARIABLE:
If(Form event=On Load)
C_TEXT($init)
$Ptr_object:=OBJECT Get pointer(Object named;"comments")
$init:=""
VARIABLE TO VARIABLE(Current process;$Ptr_object->;$init)
End if
No código 4D, as variáveis dinâmicas podem ser acessadas através de um ponteiro obtido com o comando OBJECT Get pointer. Por exemplo:
// atribuir a hora 12:00:00 à variável do objeto "tstart"
$p :=OBJECT Get pointer(Object named; "tstart")
$p->:=?12:00:00?
Este mecanismo tem duas vantagens:
- Por um lado, ele permite o desenvolvimento de componentes do tipo "subformulário" que podem ser usados várias vezes no mesmo formulário host. Tomemos como exemplo o caso de um subformulário datepicker que é inserido duas vezes em um formulário host para definir uma data inicial e uma data final. Esse subformulário usará objetos para escolher a data do mês e do ano. Será necessário que esses objetos trabalhem com variáveis diferentes para a data de início e a data de término. Permitir que 4D crie sua variável com um nome exclusivo é uma forma de resolver essa dificuldade.
- Por outro lado, pode ser utilizado para limitar a utilização da memória. De facto, os objectos formulário só funcionam com variáveis processo ou inter-processo. No entanto, no modo compilado, uma instância de cada variável de processo é criada em todos os processos, incluindo os processos do servidor. Essa instância ocupa memória, mesmo quando o formulário não é usado durante a sessão. Portanto, permitir que 4D crie variáveis dinamicamente ao carregar os formulários pode economizar memória.
List box array
Para uma caixa de lista de arrays a propriedade Variável ou Expressão geralmente contém o nome da variável array definida para a caixa de lista, e para cada coluna. No entanto, você pode usar uma matriz de strings (contendo nomes de matrizes) como valor de dataSource para uma coluna de caixa de listagem para definir uma caixa de listagem hierárquica.
Objectos compatíveis
Área 4D View Pro - Área 4D Write Pro - Botão - Grade de botões - Caixa de seleção - Combo Box - Lista suspensa - Lista hierárquica - List Box - Coluna List Box - Cabeçalho de List Box - Rodapé de List Box - Menu pop-up imagem - Área de plug-in - Indicador de progresso - Botão rádio - Spinner - Divisor - Stepper - Subformulário - Controle de tabulação - Área da Web
Tipo de expressão
Essa propriedade é chamada de Tipo de dados na Lista de propriedades para colunas de caixas de listagem do tipo seleção e coleção e para listas suspensas associadas a um objeto ou a uma matriz.
Especifique o tipo de dados para a expressão ou variável associada ao objeto. Observe que o principal objetivo dessa configuração é definir as opções (como formatos de exibição) disponíveis para o tipo de dados. Não digita efetivamente a variável em si. Em vista da compilação de um banco de dados, deve utilizar os comandos da linguagem 4D do tema Compilador.
No entanto, essa propriedade tem uma função de digitação nos seguintes casos específicos:
- **Variáveis dinâmicas**Variáveis dinâmicas: você pode usar essa propriedade para declarar o tipo de variáveis dinâmicas.
- **Colunas da caixa de listagem**Colunas: essa propriedade é usada para associar um formato de exibição aos dados da coluna. Os formatos fornecidos dependerão do tipo de variável (caixa de lista de tipos de matriz) ou do tipo de data/campo (caixas de lista de tipos de coleção e seleção). Os formatos padrão 4D que podem ser usados são: Alfa, Numeric, Data, Hora, Imagem e Booleano. O tipo de texto não tem formatos de visualização específicos. Também estão disponíveis quaisquer formatos personalizados existentes.
- **Variáveis de imagem**Variáveis de imagem: você pode usar esse menu para declarar as variáveis antes de carregar o formulário no modo interpretado. Mecanismos nativos específicos governam a exibição de variáveis de imagens em formas. Esses mecanismos requerem maior precisão na configuração das variáveis: a partir de agora, elas devem já ter sido declaradas antes de carregarem o formulário — i. ., mesmo antes do evento
On Loaddo formulário — ao contrário de outros tipos de variáveis. Para fazer isso, você também precisa que o comandoC_PICTURE(varName)tenha sido executado antes de carregar o formulário (tipicamente, no método chamando o comandoDIALOG), ou para que a variável tenha sido digitada no nível do formulário usando a propriedade do tipo de expressão. Caso contrário, a variável de imagem não será exibida corretamente (apenas no modo de interpretação).
Gramática JSON
| Nome | Tipo de dados | Valores possíveis |
|---|---|---|
| dataSourceTypeHint | string |
Objectos suportados
Caixa de seleção - Combo Box - Lista suspensa - Entrada - Coluna de List Box - Rodapé de List Box - Área de plug-in - Indicador de progresso - Botão rádio - Régua - Spinner - Stepper - Subformulário - Controle de tabulação
Classe CSS
Uma lista de palavras separadas por espaços utilizadas como seletores de classe em ficheiros css.
Gramática JSON
| Nome | Tipo de dados | Valores possíveis |
|---|---|---|
| "class" | string | Uma cadeia de caracteres com o(s) nome(s) do CSS separados por caracteres de espaço |
Objectos suportados
Área 4D View Pro - Área 4D Write Pro - Botão - Grade de botões - Caixa de seleção - Combo Box - Lista suspensa - Caixa de grupo - Lista hierárquica - List Box - Botão imagem - Menu pop-up imagem - Área de plug-in - Botão rádio - Imagem estática - Subformulário - Área de texto - Área da Web
Seleção de entidade ou coleção
Para usar elementos da coleção ou entidades para definir o conteúdo da linha da caixa de lista.
Insira uma expressão que retorne uma coleção ou uma seleção de entidades. Geralmente, você irá digitar o nome de uma variável, um elemento de coleção ou uma propriedade que contém uma coleção ou uma seleção de entidade.
A coleção ou a seleção da entidade deve estar disponível para o formulário quando for carregada. Cada elemento da coleção ou cada entidade da seleção de entidades será associado a uma linha da caixa de listagem e estará disponível como um objeto por meio da função This palavra-chave:
- Se você usou uma coleção de objetos, poderá chamar This na expressão do datasource para acessar cada valor de propriedade, por exemplo,
This.<propertyPath>. - Se você usou uma seleção de entidade, poderá chamar This na expressão de fonte de dados para acessar cada valor de atributo, por exemplo,
This.<attributePath>.
Se você usou uma coleção de valores escalares (e não objetos), 4D permite que você exiba cada valor chamando This.value na expressão de fonte de dados. No entanto, neste caso, você não será capaz de modificar valores ou acessar o objeto atual (veja abaixo).
Gramática JSON
| Nome | Tipo de dados | Valores possíveis |
|---|---|---|
| dataSource | string | Expressão que devolve uma coleção ou uma seleção de entidades. |
Objectos suportados
Fonte de dados
Especifique o tipo de list box.
- Arrays(padrão): usa elementos de array como as linhas da caixa de listagem.
- Current Selection (Seleção atual): use expressões, campos ou métodos cujos valores serão avaliados para cada registro da seleção atual de uma tabela.
- Seleção nomeada: use expressões, campos ou métodos cujos valores serão avaliados para cada registro de uma seleção nomeada.
- ** Coleção ou Seleção de Entidade**: usar elementos da coleção ou entidades para definir o conteúdo da linha da caixa de lista. Note que com este tipo de caixa de lista, você precisa definir a propriedade coleção ou Seleção de Entidades.
Gramática JSON
| Nome | Tipo de dados | Valores possíveis |
|---|---|---|
| listboxType | string | "array", "currentSelection", "namedSelection", "collection" |
Objectos suportados
Tipo de plug-in
Nome da área externa do plug-in associada ao objeto. Os nomes das áreas externas do plug-in são publicados no arquivo manifest.json do plug-in.
Gramática JSON
| Nome | Tipo de dados | Valores possíveis |
|---|---|---|
| pluginAreaKind | string | Nome da área externa do plug-in (começa com um carácter %) |
Objectos suportados
Grupo Rádio
Permite que os botões de opção sejam usados em conjuntos coordenados: apenas um botão de cada vez pode ser selecionado no conjunto.
Gramática JSON
| Nome | Tipo de dados | Valores possíveis |
|---|---|---|
| radioGroup | string | Nome do grupo rádio |
Objectos suportados
Título
Permite inserir uma etiqueta num objeto. O tipo de letra e o estilo desta etiqueta podem ser especificados.
Pode forçar um retorno de carro na etiqueta utilizando o carácter \ (barra invertida).
Para inserir um \ na etiqueta, introduzir "\\".
Por padrão, a etiqueta é colocada no centro do objeto. Quando o objeto também contém um ícone, você pode modificar a localização relativa desses dois elementos usando a propriedade Title/Picture Position.
Para a tradução do banco de dados, pode introduzir uma referência XLIFF na área do título de um botão (ver Apêndice B: arquitetura XLIFF).
Gramática JSON
| Nome | Tipo de dados | Valores possíveis |
|---|---|---|
| text | string | qualquer texto |
Objectos suportados
Button - Check Box - List Box Header - Radio Button - Text Area
Cálculo de variáveis
Essa propriedade define o tipo de cálculo a ser feito em uma área de rodapé de coluna.
Ó cálculo de rodapés também pode ser definido com o comando 4D
LISTBOX SET FOOTER CALCULATION.
Existem vários tipos de cálculos disponíveis. A tabela a seguir mostra quais cálculos podem ser usados de acordo com o tipo de dados encontrados em cada coluna e indica que o tipo é automaticamente afetado por 4D para a variável de rodapé (se não for digitado pelo código):
| Cálculo | Num | Text | Date | Hora | Bool | Pict | tipo var rodapé |
|---|---|---|---|---|---|---|---|
| Mínimo | X | X | X | X | X | Igual ao tipo de coluna | |
| Máximo | X | X | X | X | X | Igual ao tipo de coluna | |
| Soma | X | X | X | Igual ao tipo de coluna | |||
| Contagem | X | X | X | X | X | X | Integer |
| Média | X | X | Real | ||||
| Desvio padrão(*) | X | X | Real | ||||
| Variância(*) | X | X | Real | ||||
| Soma dos quadrados(*) | X | X | Real | ||||
| Personalizado ("none") | X | X | X | X | X | X | Qualquer |
(*) Apenas para list boxes do tipo array.
Somente variáveis declaradas ou dinâmicas podem ser usadas para exibir cálculos de rodapé. Outros tipos de expressões como
Form.valuenão são suportados.
Os cálculos automáticos ignoram o estado mostrado/oculto das linhas da caixa de listagem. Se você quiser restringir um cálculo para apenas linhas visíveis, você deve usar um cálculo personalizado.
Os valores nulos não são levados em conta em nenhum cálculo.
Se a coluna contiver diferentes tipos de valores (coluna baseada em coleção, por exemplo):
- A média e a soma levam em conta apenas os elementos numéricos (outros tipos de elementos são ignorados).
- Minimum e Maximum retornam um resultado de acordo com a ordem usual da lista de tipos, conforme definido na função collection.sort().
O uso de cálculos automáticos em rodapés de colunas com base em expressões tem as seguintes limitações:
- é compatível com todos os tipos de caixa de listagem quando a expressão é "simples" (como
[table]fieldouthis.attribute), - É compatível, mas não é recomendado por motivos de desempenho, com caixas de listagem de seleção de coleção/entidade quando a expressão é "complexa" (diferente de
this.attribute) e a caixa de listagem contém um grande número de linhas, - não é compatível com as caixas de listagem de seleção atual/seleção nomeada quando a expressão é "complexa". Precisa utilizar cálculos personalizados.
Quando Custom ("nenhum" em JSON) for definido, nenhum cálculo automático é realizado por 4D e você deve atribuir o valor da variável nesta área por programação.
Gramática JSON
| Nome | Tipo de dados | Valores possíveis |
|---|---|---|
| variableCalculation | string | "none", "minimum", "maximum", "sum", "count", "average", "standardDeviation", "variance", "sumSquare" |