4D v16.3

GET LIST ITEM PARAMETER ARRAYS

Página Inicial

 
4D v16.3
GET LIST ITEM PARAMETER ARRAYS

GET LIST ITEM PARAMETER ARRAYS 


 

GET LIST ITEM PARAMETER ARRAYS ( {* ;} list ; refElemento ; arrSeletores {; arrValores} ) 
Parâmetro Tipo   Descrição
Operador in Se for especificada, a lista é um nome de objeto (cadeia) Se for omitida, a lista é um número de referencia de lista
list  ListRef, String in Número de referencia de lista ou Nome de objeto de tipo lista (se passado *)
refElemento  Inteiro longo, Operador in Número de referencia do elemento ou 0 para o último elemento agregado à lista ou * para o elemento atual da lista
arrSeletores  Array texto in Array dos nomes dos parâmetros
arrValores  Array texto in Array dos valores dos parâmetros

O comando GET LIST ITEM PARAMETER ARRAYS permite recuperar somente em uma chamada o conjunto dos parâmetros (também como, opcionalmente, seus valores) associados ao elemento refElemento da lista hierárquica cuja referencia ou nome de objeto se passou no parâmetro lista.

O parâmetros associados aos elementos permitem armazenar informação adicional sobre cada elemento. Se definem com a ajuda do comando SET LIST ITEM PARAMETER.

É passado 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 passado este parâmetro, indica que o parâmetro lista é uma referencia de lista hierárquica (RefList). É utilizado somente uma representação de lista ou trabalha com os elementos estruturais (o segundo * é omitido), pode utilizar indiferentemente uma ou outra sintaxes. No entanto, varias representações são utilizadas de uma mesma lista e trabalha com o elemento atual (se passa o segundo *), deve utilizar a sintaxes baseada no nome do objeto, porque cada representação pode ter seu próprio elemento atual.

GET LIST ITEM PARAMETER ARRAYS devolve os parâmetros definidos para o elemento refElemento no array texto arrSeletores. Quando se passa o array texto arrValores, o comando utiliza para devolver os valores associados com estes parâmetros.

arrValores deve ser um array de tipo texto. Se tem valores associados que não são textuais (tipo numérico ou Booleano), convertidos em cadeias (True="1", False="0").

Exemplo  

Dada a seguinte lista hierárquica:

 <>HL:=New list
 $ID:=30
 APPEND TO LIST(<>HL;"Martin";$ID)
  //5 parâmetros
 SET LIST ITEM PARAMETER(<>HL;$ID;"Nome";"Phil")
 SET LIST ITEM PARAMETER(<>HL;$ID;"Data de nascimento";"01/02/1978")
 SET LIST ITEM PARAMETER(<>HL;$ID;"Homem";True//Booleano
 SET LIST ITEM PARAMETER(<>HL;$ID;"Idade";33) //número
 SET LIST ITEM PARAMETER(<>HL;$ID;"Cidade";"Dallas")

Para maior simplicidade a lista se associou a uma lista objeto com o mesmo nome ("<>HL").

Quando o elemento "Martin" é selecionado na lista, pode recuperar seus parâmetros executando o seguinte código:

 ARRAY TEXT(arrParamNames;0)
 GET LIST ITEM PARAMETER ARRAYS(*;"<>HL";arrParamNames)
  // arrParamNames{1} contém "Nome"
  // arrParamNames{2} contém "Data de nascimento"
  // arrParamNames{3} contém "Homem"
  // arrParamNames{4} contém "Idade"
  // arrParamNames{5} contém "Cidade"

Caso também queiras obter os valores dos parâmetros, escreva:

 ARRAY TEXT(arrParamNames;0)
 ARRAY TEXT(arrParamValues;0)
 GET LIST ITEM PARAMETER ARRAYS(*;"<>HL";arrParamNames;arrParamValues)
  // arrParamValues{1} contém "Phil"
  // arrParamValues{2} contém "01/02/1978"
  // arrParamValues{3} contém "1"
  // arrParamValues{4} contém "33"
  // arrParamValues{5} contém "Dallas"



Ver também 

SET LIST ITEM PARAMETER

 
PROPRIEDADES 

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

 
HISTÓRIA 

Criado por: 4D v13

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)