4D v14.3

List item parent

Página Inicial

 
4D v14.3
List item parent

List item parent 


 

List item parent ( {* ;} lista ; refElem | * ) -> Resultado 
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
Resultado  Inteiro longo in Número de referência do elemento pai ou 0 se não há

O comando List item parent retorna o número de referência do elemento pai.

Passe em lista o número de referência ou o nome de objeto da 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 List item parent só aplicará ao primeiro objeto cujo nome corresponda.

Passe em refElem um número de referência de elemento na lista, ou 0 ou * novamente. Se passa 0, o comando aplica ao último elemento adicionado à lista. Se passa *, o comando aplica o elemento atual da lista. Se vários elementos foram selecionados manualmente, o elemento atual é o último elemento selecionado.

Por outro lado, se o elemento correspondente existe na lista e se este elemento está em uma sub-lista (e portanto tem um elemento pai), você obtém o número de referência do elemento pai.

Se não existir um elemento com o número de referência que passou, ou se passou * e nenhum elemento estiver selecionado, ou se o elemento não tiver pai, List item parent retorna 0 (zero).

Se trabalha com números de referência dos elementos, tenha certeza de construir uma lista na qual os elementos tenham números de referência únicos; do contrário não poderá diferenciar os elementos. Para maior informação, consulte o comando APPEND TO LIST.

Exemplo  

Aqui há uma lista chamada hList mostrada no ambiente Aplicação:

Os números de referência dos elementos são os seguintes:

ElementoNúmero
a100
a - 1101
a - 2102
a - 3103
b200
b - 1201
b - 2202
b - 3203

  • No seguinte código, se for selecionado o elemento “b - 3”, a variável $vlPaiElemRef toma o valor 200, ou seja, o número de referência do elemento “b”:
 $vlItemPos:=Selected list items(hList)
 GET LIST ITEM(hList;$vlItemPos;$vlItemRef;$vsItemText)
 $vlPaiElemRef :=List item parent(hList;$vlItemRef` $vlPaiElemRef vale 200
  • Se for selecionado o elemento “a - 1”, a variável $vlPaiElemRef toma o valor 100, ou seja o número de referência do elemento “a”.
  • Se for selecionado o elemento “a” ou “b”, a variável $vlPaiElemRef toma o valor 0, porque estes elementos não tem elemento pai.

 
PROPRIEDADES 

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

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

GET LIST ITEM
List item position
SELECT LIST ITEMS BY REFERENCE
SET LIST ITEM

 
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)