4D Doc Center : SET LIST PROPERTIES

4D v14.3

SET LIST PROPERTIES


SET LIST PROPERTIES ( lista ; aparencia {; icone {; alturaLinha {; duploClique {; multiSeleçao {; editavel}}}}} )

Parâmetro	Tipo	Descrição
lista	ListRef	Número de referência da lista
aparencia	Inteiro longo	Estilo gráfico da lista 1 = Lista hierárquica à Macintosh 2 = Lista hierárquica à Windows 0 = Aparição auto dependendo da plataforma
icone	Inteiro longo	ID de recurso Mac OS ‘cicn’ ou 0 = ícone por padrão da plataforma
alturaLinha	Inteiro longo	Altura mínima da linha expressada em pixels
duploClique	Inteiro longo	Expandir/Contrair sub-lista com duplo-clique 0 = Sim, 1= Não
multiSeleçao	Inteiro longo	Seleções múltiplas: 0 = Não (por padrão), 1 = Sim
editavel	Inteiro longo	0=Lista não é editável pelo usuário, 1=Lista não é editável pelo usuário (padrão)

Descrição

O comando SET LIST PROPERTIES define a aparência da lista hierárquica cuja referência é passada no parâmetro lista.

O parâmetro aparência pode ser uma das seguintes constantes pré-definidas fornecidas por 4D no tema Listas hierárquicas:

Constante	Tipo	Valor
Ala Macintosh	Inteiro longo	1
Ala Windows	Inteiro longo	2

Na aparência Windows, o ícone (+) denota os nós contraídos, e o ícone (–) os nós expandidos. Os knots sem elementos filhos não tem ícone. Esta é uma lista hierárquica padrão com aparência Windows:

Na aparência Macintosh, um ícone de flecha a direita indica os nós contraídos e uma flecha descendente indica os knots expandidos. Os nós sem elementos filhos não têm ícone. Esta é uma lista hierárquica padrão com aparência Macintosh:

Se mostrar uma lista hierárquica sem chamar SET LIST PROPERTIES ou passar 0 no parâmetro aparencia, a lista aparece com a aparência padrão, em função da plataforma selecionada no editor de formulários do ambiente Desenho.

O parâmetro icone indica os ícones que serão mostrados para cada nó. O valor passado em icone define o ícone para os nós contraídos e icone+1 define o ícone para os nós expandidos.

Por exemplo, se passa 15000, o ícone cor 'cicn' ID=15000 será mostrado para cada nó contraído e o ícone cor 'cicn' ID=15001 será mostrado para cada nó expandido.

Portanto é importante ter estes recursos de ícones de cor 'cicn' no arquivo de estrutura de seu banco. Se um ícone de cor falta, os nós correspondentes aparecem sem ícones. (Na verdade pode aproveitar isto para mostrar uma lista sem ícones).

Advertência: quando criar recursos de ícone cor 'cicn', utilize os IDs maiores ou iguais a 15000. Os números de referência de recursos inferiores a 15000 são reservados para 4D.

Os números de referência automáticos dos recursos de elementos de lista em Macintosh e Windows são expressos pelas seguintes constantes pré-definidas por 4D:

Constante	Tipo	Valor
Windows node	Inteiro longo	138
Macintosh node	Inteiro longo	860

Em outras palavras, 4D oferece os seguintes recursos 'cicn':

Número ID	Descrição
860	Nodo contraído a Macintosh
861	Nodo expandido a Macintosh
138	Nodo contraído a Windows
139	Nodo expandido a Windows

Se não passa o parâmetro icone ou passa 0, os nodos são mostrados com os icones do tipo padrão da aparência escolhida.

Os recursos de ícone de cor podem ser de diferentes tamanhos. Por exemplo, pode criar ícones de cor de 16x16 ou 32x32.

Se não passa o parâmetro alturaLinha, a altura de linha de uma lista hierárquica é determinada pela fonte e o tamanho de fonte utilizado pelo objeto. Se utilizar ícones de cores que são muito grandes ou muito largos, são mostrados truncados ou deformados pelo texto dos nós superiores ou inferiores.

Selecione o tamanho do ícone de cor, fonte e tamanho de fonte adequadamente, do contrário passe no parâmetro alturaLinha a altura mínima das linhas da lista hierárquica. Se o valor que passa é superior à altura das linhas definida pela fonte e o tamanho de fonte utilizado, a altura das linhas da lista hierárquica será o valor passado.

Nota: SET LIST PROPERTIES afeta a aparência dos nós na lista hierárquica. Se preferir personalizar o ícone de cada elemento na lista, utilize o comando SET LIST ITEM PROPERTIES.

O parâmetro opcional duploClique lhe permite definir duplo clique em um elemento da lista pai não provoque a expansão ou contração da sub-lista. Como padrão, um duplo clique em um item da lista pai provoca que sua lista filho se expanda ou se contraia. Entretanto, algumas interfaces de usuário poderiam necessitar desativar este mecanismo. Para fazer isto, passe 1 no parâmetro duploClique.

Só serão desativados duplo cliques. Os usuários ainda poderão expandir ou contrair as sub-listas clicando no nó da lista.

Se omitir o parâmetro duploClique ou passa 0, é aplicado o funcionamento padrão.

O parâmetro opcional multiSeleçao lhe permite indicar se a lista deve aceitar seleções múltiplas.

Automaticamente, como em versões anteriores de 4D, você não pode selecionar vários elementos de uma lista hierárquica simultaneamente. Se deseja que esta função esteja disponível para a lista, passe o valor 1 no parâmetro multiSeleçao. Nesse caso, as seleções múltiplas podem ser realizadas:

- manualmente, utilizando a combinação de teclas Shift+clique para una seleção continua ou Ctrl+clique (Windows) / comando+clique (Mac OS) para uma seleção descontinúa,
- por programação, utilizando os comandos SELECT LIST ITEMS BY POSITION e SELECT LIST ITEMS BY REFERENCE.
Se passa 0 e omite o parâmetro multiSeleçao, se aplicará o comportamento padrão.

O parâmetro opcional editavel lhe permite indicar se a lista deve ser editável pelo usuário quando é mostrada como uma lista de seleção associada a um campo ou a uma variável durante a entrada de dados. Quando a lista é editável, um botão Modificar é adicionado na janela da lista e o usuário pode adicionar, apagar e ordenar os valores através de um editor específico.
Se passa 1 ou omite o parâmetro editavel , a lista será editável; se passa 0, não será editável.

Exemplo

A seguinte lista hierárquica foi definida no editor de listas no ambiente Desenho:

Em um formulário, o objeto lista hierárquica hlCiudades reutiliza essa lista com este método de objeto:

 Case of

    :(Form event=On Load)

       hlCidades:=Load list("Cidades")

       SET LIST PROPERTIES(hlCidades;vlAparencia;vlIcon)

    :(Form event=On Unload)

       CLEAR LIST(hlCidades;*)

 End case