4D v14.3

SET LIST ITEM PARAMETER

Página Inicial

 
4D v14.3
SET LIST ITEM PARAMETER

SET LIST ITEM PARAMETER 


 

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

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.

 
PROPRIEDADES 

Produto: 4D
Tema: Listas Hierárquicas
Número 986

 
HISTÓRIA 

Criado por: 4D v11 SQL

 
VER TAMBÉM 

GET LIST ITEM PARAMETER
GET LIST ITEM PARAMETER ARRAYS

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)