OBJECT Get list reference

4D v18


OBJECT Get list reference ( {* ;} objeto {; tipoLista} ) -> Resultado

Parâmetro	Tipo	Descrição
*	Operador	Se especificado, objeto é um nome de objeto (cadeia) Se omitido, objeto é um campo ou uma variável
objeto	Objeto de formulário	Nome de objeto (se * for especificado) ou Campo ou variável (se * for omitido)
tipoLista	Inteiro longo	Tipo de lista: lista de Seleção, lista obrigatória ou a lista de excluídos
Resultado	ListRef	Número de referência de lista

Descrição

O comando OBJECT Get list reference devolve o número de referência (RefList) da lista hierárquica associada ao objeto ou grupo de objetos designados pelos parâmetros objeto e * .

Se passar o parâmetro opcional * indica que o parâmetro objeto é um nome de objeto (cadeia). Se não passar este parâmetro, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, se passa uma referência de campo ou variável em lugar de uma cadeia (campo ou variável objeto unicamente).

Por padrão, se omite o parâmetro tipoLista, o comando devolve o nome da lista de opções (lista de valores) associado ao objeto. Também pode obter o número de referência das listas obrigatória ou as listas de excluídos passando em tipoLista, uma das seguintes constantes do tema "Propriedades dos objetos ":

Constante	Tipo	Valor	Comentário
Choice list	Inteiro longo	0	Lista simples de seleção de valores (opção "Lista" na Lista de Propriedades) (por padrão)
Excluded list	Inteiro longo	2	Lista de valores não aceitos para a entrada (Opção "Exclusões" na lista de propriedades)
Required list	Inteiro longo	1	Lista só os valores aceitos para a entrada (Opção "Obrigatória" na Lista de Propriedades)

Se não há uma lista hierárquica associada ao objeto para o tipoLista definido, o comando devolve 0.

Ver também

OBJECT Get list name
OBJECT SET LIST BY REFERENCE