SELECT LIST ITEMS BY REFERENCE

4D v16.3


SELECT LIST ITEMS BY REFERENCE ( lista ; refElem {; refArray} )

Parâmetro	Tipo	Descrição
lista	ListRef	Número de referência da lista
refElem	Inteiro longo	Número de referência do elemento ou 0 para o último elemento adicionado à lista
refArray	Array inteiro longo	Array de números de referência de elementos

Descrição

O comando SELECT LIST ITEMS BY REFERENCE seleciona os elementos cujo número de referência se passa em refElem e opcionalmente em refArray, na lista cujo número de referência se passa em lista.

Se nenhum elemento tem o número de referência que passou, o comando não faz nada.

Se um elemento não é visível atualmente (por exemplo, se estiver localizado em uma lista contraída), o comando expande as sub-listas correspondentes de maneira que fiquem visíveis.

Se não passar o parâmetro refArray, o parâmetro refElem representa a referência do elemento a ser selecionado. Se o número de elemento não corresponde a nenhum elemento da lista, o comando não faz nada. Igualmente pode passar o valor 0 neste parâmetro para designar o último elemento adicionado à lista.

O parâmetro opcional refArray lhe permite selecionar vários elementos simultaneamente na lista. Em refArray, deve passar um array onde cada linha indique a referência fixa de um elemento a ser selecionado.
Neste caso, o elemento designado pelo parâmetro refElem determina o novo elemento atual da lista na seleção resultante, o qual pode pertencer ou não ao conjunto de elementos definido pelo array. O elemento atual é, mais particularmente, o que é editado pelo comando EDIT ITEM.

Nota: para selecionar vários elementos simultaneamente em uma lista hierárquica (manualmente ou por programação), a propriedade multi-selecionavel deve ter sido selecionada para a lista. Esta propriedade é definida utilizando o comando SET LIST PROPERTIES.

Se trabalha com os 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á diferenciá-los. Para maior informação, consulte a descrição do comando APPEND TO LIST.

Exemplo

hList é uma lista cujos elementos tem números de referência únicos. O método a seguir de objeto para um botão seleciona o item pai (se o houver) do elemento selecionado atualmente:

 $vlItemPos:=Selected list items(hList) ` Obter a posição do elemento selecionado

 GET LIST ITEM(hList;$vlItemPos;$vlItemRef;$vsItemText) ` Obter o número de referência do elemento selecionado

 $vlParentItemRef:=List item parent(hList;$vlItemRef) ` Obter número de referência do item pai (se o houver)

 If($vlParentItemRef>0)

    SELECT LIST ITEM BY REFERENCE(hList;List item parent(hList;$vlItemRef)) ` Seleçao do elemento pai End if

Ver também

EDIT ITEM
SELECT LIST ITEMS BY POSITION
Selected list items