4D v14.3

GET LIST ITEM

Página Inicial

 
4D v14.3
GET LIST ITEM

GET LIST ITEM 


 

GET LIST ITEM ( {* ;} lista ; posiçaoElem | * ; refElem ; textoElem {; sublista ; expandida} ) 
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 *)
posiçaoElem | *   Operador, Inteiro longo in Posição do elemento em lista(s) expandida(s) ou contraída(s) * para o elemento atual da lista.
refElem  Inteiro longo in Número de referência do elemento
textoElem  cadeia in Texto do elemento da lista
sublista  ListRef in Número de referência da sub-lista (se existe)
expandida  Booleano in Se uma sub-lista está associada: TRUE = a sub-lista está expandida FALSE = a sub-lista está contraída

O comando GET LIST ITEM retorna a informação sobre o elemento especificado por posiçaoElem da lista cujo número de referencia ou nome de objeto se passa em lista.

Se passa o primeiro parâmetro opcional *, indica que o parâmetro lista é um nome de objeto (cadeia) correspondente a uma representação de 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 utilizada apenas uma representação de lista, pode utilizar indiferentemente uma ou outra sintaxe. Por outro lado, se usar várias representações de uma mesma lista, a lista baseada no nome do objeto é necessária já que cada representação pode ter sua própria configuração expandida/contraída e seu próprio elemento atual.

Nota: se utilizar o caractere @ no nome da lista e o formulário contém várias listas que respondem a este nome, o comando GET LIST ITEM só aplicará ao primeiro objeto cujo nome corresponda.

A posição deve ser expressa com relação ao  estado atual expandido/contraído da lista e de sua sublista. Deve passar um valor de posição entre 1 e o valor retornado por Count list items. Se passa um valor que não estiver nesta faixa, GET LIST ITEM retorna valores vazios (0, "", etc.).

Depois da chamada, recupera:

  • O número de referência do elemento em refElem.
  • O texto do elemento em textoElem.

Se passa os parâmetros opcionais sublista e expandida:

  • sublista retorna o número de referência da sub-lista associada ao elemento. Se  o elemento não tem sub-lista, sublista retorna zero (0).
  • Se o elemento tem uma sub-lista, expandida retorna TRUE se a sub-lista está expandida, e FALSE se está contraída.

hList é uma lista cujos elementos têm números de referência únicos. O código a seguir passa por programação ao estado expandido/contraído da sub-lista, se houver, associada ao elemento selecionado:

 $vlItemPos:=Selected list items(hList)
 If($vlItemPos>0)
    GET LIST ITEM(hList;$vlItemPos;$vlItemRef;$vsItemText;$hSublist;$vbExpandida)
    If(Is a list($hSublist))
       SET LIST ITEM(hList;$vlItemRef;$vsItemText;$vlItemRef;$hSublist;Not($vbExpandida))
    End if
 End if

Consulte o exemplo do comando APPEND TO LIST.

 
PROPRIEDADES 

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

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

GET LIST ITEM PROPERTIES
List item parent
List item position
Selected list items
SET LIST ITEM
SET LIST ITEM PROPERTIES

 
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)