4D v16.3SELECT LIST ITEMS BY POSITION |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16.3
SELECT LIST ITEMS BY POSITION
SELECT LIST ITEMS BY POSITION
O comando SELECT LIST ITEMS BY POSITION seleciona os elementos cuja posição se passa em posiçaoElem e opcionalmente em posiçaoArray na lista cujo número de referência ou nome de objeto é passada em 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 passa este parâmetro, indica que o parâmetro lista é uma referência de lista hierárquica (RefLista). Se utiliza só uma representação de lista, pode utilizar indiferentemente uma ou outra sintaxe. Pelo contrário, se utiliza 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. 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 SELECT LIST ITEMS BY POSITION só aplicará ao primeiro objeto cujo nome corresponde. A posição dos elementos sempre é expressa utilizando o estado expandido/contraído da lista e suas sub-listas. Você passa um valor de posição entre 1 e o valor retornado por Count list items. Se passar um valor fora dessa faixa, não é selecionado nenhum elemento. Se não passar o parâmetro posiçaoArray, o parâmetro posiçaoElem representa a posição do elemento a selecionar. O parâmetro opcional posiçaoArray lhe permite selecionar vários elementos simultaneamente da lista. Em posicionArray, deve passar um array onde cada linha indique a posição de um elemento a selecionar. Nota: para que vários elementos possam ser selecionados simultaneamente em uma lista hierárquica (manualmente ou por programação), a propriedade multi-selecionavel deve ter sido ativada para a lista. Esta propriedade se define utilizando o comando SET LIST PROPERTIES. Dada a lista hierárquica chamada hList, mostrada no ambiente Aplicação: Depois da execução deste código:
SELECT LIST ITEMS BY POSITION(hList;Count list items(hList)) O último elemento visível da lista é selecionado: Depois da execução das seguintes linhas de código: SET LIST PROPERTIES(hList;0;0;18;0;1) São selecionados os elementos segundo, terceiro e quinto da lista hierárquica
Ver também
EDIT ITEM
|
PROPRIEDADES
Produto: 4D
HISTÓRIA
Modificado: 4D v11 SQL ARTICLE USAGE
Manual de linguagem 4D ( 4D v16) |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||