List Box

---

Colunas

Coleção de colunas do list box.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
columns	colecção de objectos coluna	Contém as propriedades das colunas de list box

For a list of properties supported by column objects, please refer to the Column Specific Properties section.

Objectos suportados

List Box

---

Nome formulário detalhe

List box do tipo selecção

Specifies the form to use for modifying or displaying individual records of the list box.

O formulário especificado é apresentado:

• ao usar as ações padrão Add Subrecord e Edit Subrecord aplicadas à list box (consulte Usando ações padrão),
• quando uma linha é duplamente clicada e a propriedade Duplo clique na linha está definida como "Editar Registro" ou "Exibir Registro".

Gramática JSON

Nome	Tipo de dados	Valores possíveis
detailForm	string	Nome (string) da tabela ou formulário projeto Caminho POSIX (cadeia de caracteres) para um ficheiro .json que descreve o formulário Objeto que descreve o formulário

Objectos suportados

List Box

---

Duplo clique em linha

List box do tipo selecção

Sets the action to be performed when a user double-clicks on a row in the list box. As opções disponíveis são:

• Do nothing (default): Double-clicking a row does not trigger any automatic action.
• Edit Record: Double-clicking a row displays the corresponding record in the detail form defined for the list box. O registo é aberto em modo de leitura-escrita para poder ser modificado.
• Display Record: Identical to the previous action, except that the record is opened in read-only mode so it cannot be modified.

Double-clicking an empty row is ignored in list boxes.

Regardless of the action selected/chosen, the On Double clicked form event is generated.

For the last two actions, the On Open Detail form event is also generated. The On Close Detail is then generated when a record displayed in the detail form associated with the list box is about to be closed (regardless of whether or not the record was modified).

Gramática JSON

Nome	Tipo de dados	Valores possíveis
doubleClickInRowAction	string	"editSubrecord", "displaySubrecord"

Objectos suportados

List Box

---

Ressaltar conjunto

List box do tipo selecção

This property is used to specify the set to be used to manage highlighted records in the list box (when the Arrays data source is selected, a Boolean array with the same name as the list box is used).

4D creates a default set named ListBoxSetN where N starts at 0 and is incremented according to the number of list boxes in the form. Se necessário, pode alterar o conjunto predefinido. It can be a local, process or interprocess set (we recommend using a local set, for example $LBSet, in order to limit network traffic). É então mantido automaticamente por 4D. If the user selects one or more rows in the list box, the set is updated immediately. If you want to select one or more rows by programming, you can apply the commands of the “Sets” theme to this set.

• The highlighted status of the list box rows and the highlighted status of the table records are completely independent.
• If the “Highlight Set” property does not contain a name, it will not be possible to make selections in the list box.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
highlightSet	string	Nome do conjunto

Objectos suportados

List Box

---

Colunas bloqueadas e colunas estáticas

Locked columns and static columns are two separate and independent functionalities in list boxes:

• Locked columns always stay displayed to the left of the list box; they do not scroll horizontally.
• As colunas estáticas não podem ser movidas por arrastar e largar dentro do list box.

You can set static and locked columns by programming, refer to "List Box" section in the 4D Language Reference manual.

Estas propriedades interagem da seguinte forma:

• Se definir colunas que são apenas estáticas, estas não podem ser deslocadas.

• Se definir colunas bloqueadas, mas não estáticas, pode ainda alterar a sua posição livremente na área bloqueada. No entanto, uma coluna bloqueada não pode ser movida para fora dessa área bloqueada.

• If you set all of the columns in the locked area as static, you cannot move these columns within the locked area.

• You can set a combination of locked and static columns according to your needs. For example, if you set three locked columns and one static column, the user can swap the two right-most columns within the locked area (since only the first column is static).

Número de colunas estáticas

Number of columns that must stay permanently displayed in the left part of the list box, even when the user scrolls through the columns horizontally.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
lockedColumnCount	integer	mínimo: 0

Objectos suportados

List Box

Número de colunas

Número de colunas que não podem ser movidas durante a execução.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
staticColumnCount	integer	mínimo: 0

Objectos suportados

List Box

---

Número de colunas trancadas

Define o número de colunas do list box.

You can add or remove columns dynamically by programming, using commands such as LISTBOX INSERT COLUMN or LISTBOX DELETE COLUMN.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
columnCount	integer	mínimo: 1

Objectos suportados

List Box

---

Array controle linha

List box do tipo array

Um array 4D que controla a apresentação das linhas do list box.

Pode definir as propriedades de interface "oculto", "desativado" e "selecionável" para cada linha de um list box baseado num array utilizando este array. Também pode ser designado através do comando LISTBOX SET ARRAY.

O array de controlo de linhas deve ser do tipo Longint e incluir o mesmo número de linhas que o list box. Cada elemento do array de controlo de linha define o estado da interface da linha correspondente no list box. Three interface properties are available using constants in the "List Box" constant theme:

Parâmetros	Valor	Comentário
lk row is disabled	2	A linha correspondente é desactivada. O texto e os controlos, como as caixas de verificação, estão esbatidos ou a cinzento. As áreas de entrada de texto inserível já não são inseríveis. Valor padrão: Activado
lk row is hidden	1	A linha correspondente é ocultada. A ocultação de linhas apenas afeta a visualização do list box. The hidden rows are still present in the arrays and can be managed by programming. The language commands, more particularly LISTBOX Get number of rows or LISTBOX GET CELL POSITION, do not take the displayed/hidden status of rows into account. For example, in a list box with 10 rows where the first 9 rows are hidden, LISTBOX Get number of rows returns 10. From the user’s point of view, the presence of hidden rows in a list box is not visibly discernible. Somente as linhas visíveis podem ser selecionadas (por exemplo, usando o comando Selecionar tudo). Valor padrão: Visível
lk row is not selectable	4	A linha correspondente não é selecionável (não é possível realçar). Enterable text input areas are no longer enterable unless the Single-Click Edit option is enabled. No entanto, os controlos como as caixas de verificação e as listas continuam a funcionar. Esta definição é ignorada se o modo de seleção do list box é "Nenhum". Valor por defeito: Selecionável

To change the status for a row, you just need to set the appropriate constant(s) to the corresponding array element. Por exemplo, se não quiser que a linha #10 seja selecionável, você pode digitar:

 aLControlArr{10}:=lk row is not selectable

É possível definir várias propriedades de interface de uma só vez:

 aLControlArr{8}:=lk row is not selectable + lk row is disabled

Note that setting properties for an element overrides any other values for this element (if not reset). Por exemplo:

 aLControlArr{6}:=lk row is disabled + lk row is not selectable
 //define a linha 6 como desativada E não selecionável
 aLControlArr{6}:=lk row is disabled
 //define a linha 6 como desativada mas selecionável novamente

Gramática JSON

Nome	Tipo de dados	Valores possíveis
rowControlSource	string	Nome do array de controlo de linha

Objectos suportados

List Box

---

Modo seleção

Designa a opção que permite aos utilizadores selecionar linhas:

• None: Rows cannot be selected if this mode is chosen. Clicking on the list will have no effect unless the Single-Click Edit option is enabled. The navigation keys only cause the list to scroll; the On Selection Change form event is not generated.
• Single: One row at a time can be selected in this mode. 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. The On Selection Change form event is generated every time the current row is changed.
• Multiple: Several rows can be selected simultaneously in this mode.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
selectionMode	string	"multiple", "single", "none"

Objectos suportados

List Box