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

OBJECT Get list name

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

ParâmetroTipoDescrição
*OperadorSe especificado, objeto é um nome de objeto (string). Se omitido, objeto é uma variável ou campo.
objetoanyNome de objeto (se * for especificado) ou Variável ou campo (se * for omitido)
tipoListaIntegerTipo de lista: lista de seleção, lista de obrigatórios ou lista de excluídos
ResultadoTextNome da lista de escolha (especificado no modo Desenho)

Esse comando não é seguro para thread e não pode ser usado em código adequado.

Descrição

O comando OBJECT Get list name devolve o nome da lista associada ao objeto ou a um grupo de objetos designados por objeto. 4D lhe permite associar uma lista de opções (criada com o editor de listas em modo Desenho) com objetos de formulário utilizando o editor de formulários ou o comando OBJECT SET LIST BY NAME.

Se pasa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (cadeia). Se não passa este parâmetro, indica que o parâmetro objeto é um campo ou uma variável. Neeste caso, se passa uma referência de campo ou variável (campo ou variável objeto unicamente) ao invés de uma cadeia.

Pode utilizar o parâmetro opcional tipoLista para designar o tipo de lista que deseja obter. Por padrão, se omitir este parâmetro, o comando devolve o nome da lista de opções (lista de valores) associado ao objeto. Também pode obter os nomes das listas obrigatórias ou das listas de excluídos passando, em tipoLista, uma das seguintes constantes que se encontram no 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 nenhuma lista do tipo definido está associada ao objeto, o comando devolve uma cadeia vazia ("").

Ver também

OBJECT Get list reference
OBJECT SET LIST BY NAME