4D Doc Center : List item parent

4D v14.3

List item parent


List item parent ( {* ;} lista ; refElem \| * ) -> Resultado

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
Resultado	Inteiro longo	Número de referência do elemento pai ou 0 se não há

Descrição

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:

Elemento	Número
a	100
a - 1	101
a - 2	102
a - 3	103
b	200
b - 1	201
b - 2	202
b - 3	203

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.