4D v14.3List 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á | |||||
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.
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 |
$vlItemPos:=Selected list items(hList)
GET LIST ITEM(hList;$vlItemPos;$vlItemRef;$vsItemText)
$vlPaiElemRef :=List item parent(hList;$vlItemRef) ` $vlPaiElemRef vale 200
Produto: 4D
Tema: Listas Hierárquicas
Número
633
Modificado: 4D v11 SQL
GET LIST ITEM
List item position
SELECT LIST ITEMS BY REFERENCE
SET LIST ITEM
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)