Fonte de dados

Inserção automática

When this option is selected, if a user enters a value that is not found in the choice list associated with the object, this value is automatically added to the list stored in memory.

When the automatic insertion option is not selected (default), the value entered is stored in the object but not in the list in memory.

Esta propriedade é suportada por:

• the form editor's Property List.
• Combo box form objects whose associated list is filled by their array or object datasource.

For example, given a choice list containing "France, Germany, Italy" that is associated with a "Countries" combo box: if the automatic insertion property is set and a user enters "Spain", then the value "Spain" is automatically added to the list in memory:

If the list was created from a list defined in Design mode, the original list is not modified.

Gramática JSON

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

Objectos suportados

Combo Bo - Coluna List Box

---

Lista de escolha

Associa uma lista de opções a um objeto. It can be a choice list name (a list reference) or a collection of default values.

the OBJECT SET LIST BY NAME or OBJECT SET LIST BY REFERENCE commands.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
choiceList	liste, collection	Uma lista de valores possíveis
lista	liste, collection	Uma lista de valores possíveis (apenas listas hierárquicas)

Objectos suportados

Drop-down List - Combo Box - Hierarchical List - List Box Column

---

Lista de opções (lista estática)

Lista de valores estáticos a serem usados como etiquetas para o objeto de controle de tabulação.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
labels	liste, collection	Uma lista de valores para preencher o controlo de pestanas

Objectos suportados

Controles das Abas

---

Item atual

List box de tipo collection ou entity selection

Specifies a variable or expression that will be assigned the collection element/entity selected by the user. You must use an object variable or an assignable expression that accepts objects. If the user does not select anything or if you used a collection of scalar values, the Null value is assigned.

This property is "read-only", it is automatically updated according to user actions in the list box. Não é possível editar o seu valor para modificar o estado de seleção do list box.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
currentItemSource	string	Expressão de objecto

Objectos suportados

List Box

---

Posição item atual

List box de tipo collection ou entity selection

Specifies a variable or expression that will be assigned a longint indicating the position of the collection element/entity selected by the user.

• if no element/entity is selected, the variable or expression receives zero,
• if a single element/entity is selected, the variable or expression receives its location,
• if multiple elements/entities are selected, the variable or expression receives the position of element/entity that was last selected.

  This property is "read-only", it is automatically updated according to user actions in the list box. Não é possível editar o seu valor para modificar o estado de seleção do list box.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
currentItemPositionSource	string	Expressão numérica

Objectos suportados

List Box

---

Tipo de dados

Define o tipo de dados para a expressão apresentada. Esta propriedade é utilizada com:

• To be able to store the reference, the field or variable data source must be of the Number type (regardless of the type of value displayed in the list).
• Naturally, the value entered must not belong to the list of excluded values associated with the object, if one has been set.

Please refer to Expression Type section.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
dataSourceTypeHint	string	columnas list box: "boolean", "number", "picture", "text", date", "time". Apenas para Array/seleção list box: "integer", "object" listas pendentes: "object", "arrayText", "arrayDate", "arrayTime", "arrayNumber"

Objectos suportados

Drop-down List - Input - List Box Column

---

Tipo de dados (lista)

Define o tipo de dados a guardar no campo ou na variável associada à lista pendente. Esta propriedade é utilizada com:

• the Choice List JSON property
• Drop-down lists associated to a hierarchical choice list.

Estão disponíveis três opções:

• Save as Reference: the reference of the choice list item is saved in the object. This reference is the numeric value associated with each item either through the itemRef parameter of the APPEND TO LIST or SET LIST ITEM commands, or in the lists editor.
• Save as Value (default option): the value of the item chosen in the list by the user is saved directly. For example, if the user chooses the value "Blue", then this value is saved in the field.
• Selected item reference: the drop-down list is not hierarchical and the reference of the choice list item is saved in the object. Esta referência é o valor numérico associado a cada item, quer através do parâmetro itemRef dos comandos APPEND TO LIST ou SET LIST ITEM, quer no editor de listas. This option lets you optimize memory usage: storing numeric values in fields uses less space than storing strings. It also makes it easier to translate applications: you just create multiple lists in different languages but with the same item references, then load the list based on the language of the application.

Using the Selected item reference option requires compliance with the following principles:

• To be able to store the reference, the field or variable data source must be of the Number type (regardless of the type of value displayed in the list). The expression property is automatically set.
• Devem ser associadas referências válidas e únicas aos itens da lista.
• A lista pendente deve estar associada a um campo ou a uma variável.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
saveAs	string	"value", "reference"

Setting only "dataSourceTypeHint" : "integer" with a "type": "dropdown" form object will declare a hierarchical drop-down list.

Objectos suportados

If you use this property for a drop-down list, it must be associated with a field.

---

Valores padrão (lista de)

List of values that will be used as default values for the list box column (array type only). These values are automatically available in the array variable associated with this column when the form is executed. Using the language, you can manage the object by referring to this array.

Do not make confusion between this property and the "default value" property that allows to define a field value in new records.

É necessário introduzir uma lista de valores. In the Form editor, a specific dialog box allows you to enter values separated by carriage returns:

You can also define a choice list with the list box column. However, a choice list will be used as list of selectable values for each column row, whereas the default list fill all column rows.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
values	collection	Uma coleção de valores por defeito (cadeias de caracteres), por exemplo: "a", "b", "c", "d"

Objectos suportados

Coluna List Box (apenas tipo array)

---

Expression

This description is specific to selection and collection type list box columns. See also Variable or Expression section.

Uma expressão 4D a associar a uma coluna. Você pode entrar:

• A simple variable (in this case, it must be explicitly declared for compilation). Pode utilizar qualquer tipo de variável, exceto BLOBs e arrays. The value of the variable will be generally calculated in the On Display Detail event.

• A field using the standard [Table]Field syntax (selection type list box only), for example: [Employees]LastName. Podem ser utilizados os seguintes tipos de campos:

  • String
  • Numeric
  • Date
  • Hora
  • Imagem
  • Boolean
    You can use fields from the Master Table or from other tables.

• A 4D expression (simple expression, formula or 4D method). A expressão deve devolver um valor. The value will be evaluated in the On Display Detail and On Data Change events. O resultado da expressão será automaticamente apresentado quando mudar para o modo Aplicação. The expression will be evaluated for each record of the selection (current or named) of the Master Table (for selection type list boxes), each element of the collection (for collection type list boxes) or each entity of the selection (for entity selection list boxes). Se estiver vazia, a coluna não apresentará nenhum resultado. São suportados os seguintes tipos de expressão:

  • String

  • Numeric

  • Date

  • Imagem

  • Parâmetros

    For collection/entity selection list boxes, Null or unsupported types are displayed as empty strings.
    When using collections or entity selections, you will usually declare the element property or entity attribute associated to a column within an expression containing This. This is a dedicated 4D command that returns a reference to the currently processed element. For example, you can use **This.\<propertyPath>** where **\<propertyPath>** is the path of a property in the collection or an entity attribute path to access the current value of each element/entity. If you use a collection of scalar values, 4D will create an object for each collection element with a single property (named "value"), filled with the element value. In this case, you will use This.value as expression.

    If a non-assignable expression is used (e.g. [Person]FirstName+" "+[Person]LastName), the column is never enterable even if the Enterable property is enabled.

If a field, a variable, or an assignable expression (e.g. Person.lastName) is used, the column can be enterable or not depending on the Enterable property.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
dataSource	string	Uma variável 4D, nome de campo ou uma expressão de linguagem complexa arbitrária.

Objectos suportados

Coluna da List Box

---

Tabela mestre

Current selection list boxes

Especifica a tabela cuja seleção atual será utilizada. This table and its current selection will form the reference for the fields associated with the columns of the list box (field references or expressions containing fields). Even if some columns contain fields from other tables, the number of rows displayed will be defined by the master table.

All database tables can be used, regardless of whether the form is related to a table (table form) or not (project form).

Gramática JSON

Nome	Tipo de dados	Valores possíveis
tabela	number	Número de tabela

Objectos suportados

List Box

---

Salvar como

Esta propriedade está disponível nas seguintes condições:

• uma lista de escolha está associada ao objeto
• for inputs and list box columns, a required list is also defined for the object (both options should use usually the same list), so that only values from the list can be entered by the user.

This property specifies, in the context of a field or variable associated with a list of values, the type of contents to save:

• Save as Value (default option): the value of the item chosen in the list by the user is saved directly. For example, if the user chooses the value "Blue", then this value is saved in the field.
• Save as Reference: the reference of the choice list item is saved in the object. Esta referência é o valor numérico associado a cada item, quer através do parâmetro itemRef dos comandos APPEND TO LIST ou SET LIST ITEM, quer no editor de listas.

This option lets you optimize memory usage: storing numeric values in fields uses less space than storing strings. It also makes it easier to translate applications: you just create multiple lists in different languages but with the same item references, then load the list based on the language of the application.

A utilização deste bem exige o cumprimento dos seguintes princípios:

• To be able to store the reference, the field or variable data source must be of the Number type (regardless of the type of value displayed in the list). The expression property is automatically set.
• Devem ser associadas referências válidas e únicas aos itens da lista.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
saveAs	string	"value", "reference"

Objectos suportados

Coluna da List Box

---

Itens selecionados

List box de tipo collection ou entity selection

Specifies a variable or expression that will be assigned the elements or entities selected by the user.

• for a collection list box, you must use a collection variable or an assignable expression that accepts collections,
• para um list box seleção de entidades, é criado um objeto de seleção de entidades. You must use an object variable or an assignable expression that accepts objects.

  This property is "read-only", it is automatically updated according to user actions in the list box. Não é possível editar o seu valor para modificar o estado de seleção do list box.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
selectedItemsSource	string	Expressão da colecção

Objectos suportados

List Box

---

Nome da seleção

Named selection list boxes

Especifica a seleção nomeada a ser utilizada. Você deve inserir o nome de uma seleção nomeada válida. It can be a process or interprocess named selection. O conteúdo do list box será baseado nesta seleção. The named selection chosen must exist and be valid at the time the list box is displayed, otherwise the list box will be displayed blank.

As selecções nomeadas são listas ordenadas de registos. They are used to keep the order and current record of a selection in memory. For more information, refer to Named Selections section in the 4D Language Reference manual.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
namedSelection	string	Nome da selecção

Objectos suportados

List Box