4D Doc Center : SET LIST ITEM PARAMETER

4D v14.3

SET LIST ITEM PARAMETER


SET LIST ITEM PARAMETER ( {* ;} lista ; refElem \| * ; seletor ; valor )

Parâmetro	Tipo	Descrição
*	Operador	Se especificada, lista é um nome de objeto (cadeia) Se omitida, lista é um número de referência de lista
lista	ListRef, cadeia	Número de referência de lista (se omitida ) ou Nome do objeto de tipo lista (se passada )
refElem \| *	Operador, Inteiro longo	Número de referencia do elemento, ou 0 para o último elemento adicionado à lista ou * para o elemento da lista atualmente selecionada
seletor	cadeia	Constante do parâmetro
valor	cadeia, Booleano, Inteiro longo, Real	Valor do parâmetro

Descrição

O comando SET LIST ITEM PARAMETER permite modificar o parâmetro seletor para o elemento refElem da lista hierárquica cuja referência ou nome de objeto são passadas no parâmetro lista.

Se passa o primeiro parâmetro opcional *, indica que o parâmetro lista é um nome de objeto (cadeia) correspondente a uma representação da lista no formulário. Se não passar este parâmetro, indica que o parâmetro lista é uma referência de lista hierárquica (RefLista). Se utiliza uma só representação de lista ou trabalha com elementos estruturais (o segundo * é omitido), pode utilizar indiferentemente uma ou outra sintaxe. Pelo contrário, se utiliza várias representações de uma mesma lista e trabalha com o elemento atual (se passa o segundo *), a sintaxe baseada no nome do objeto se necessita já que cada representação pode ter seu próprio elemento atual.

Pode passar um número de referência em refElem. Se este número não corresponde a nenhum elemento da lista, o comando não faz nada. Também pode passar 0 em refElem para obter a fonte do último elemento adicionado à lista (utilizando APPEND TO LIST).

Finalmente, pode passar * em refElem: neste caso, o comando se aplicará ao elemento atual da lista. Se vários elementos são selecionados manualmente, o elemento atual é o último selecionado. Se nenhum elemento estiver selecionado, o comando não faz nada.

Em seletor, pode passar a constante Additional text (localizada no tema “Listas hierárquicas”) ou qualquer valor personalizado.

Additional Text: esta constante permite adicionar texto à direita do elemento refElem. Este título adicional sempre se mostrará na parte direita da lista, inclusive quando o usuário move o cursor de rolagem horizontal. Quando utilize esta constante, passe o texto a mostrar em valor.
Custom selector: pode passar em seletor todo texto personalizado e associá-lo com um valor de tipo texto, numérico ou booleano. Este valor será armazenado com o elemento e poderá ser recuperado utilizando o comando GET LIST ITEM PARAMETER. Este princípio permite configurar todo tipo de interface associado com as listas hierárquicas. Por exemplo, em uma lista de nomes de clientes, pode guardar a idade de cada pessoa e mostrá-la unicamente quando o elemento correspondente seja selecionado.