Saltar para o conteúdo principal
Versão: Próximo

OBJECT Get list reference

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

ParâmetroTipoDescrição
*Operador🡒Se especificado, objeto é um nome de objeto (cadeia) Se omitido, objeto é um campo ou uma variável
objetoObjeto de formulário🡒Nome de objeto (se * for especificado) ou Campo ou variável (se * for omitido)
tipoListaInteiro longo🡒Tipo de lista: lista de Seleção, lista obrigatória ou a lista de excluídos
ResultadoListRef🡐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 ":

ConstanteTipoValorComentário
Choice listInteiro longo0Lista simples de seleção de valores (opção "Lista" na Lista de Propriedades) (por padrão)
Excluded listInteiro longo2Lista de valores não aceitos para a entrada (Opção "Exclusões" na lista de propriedades)
Required listInteiro longo1Lista 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