4D v16.3

OBJECT Get list name

Página Inicial

 
4D v16.3
OBJECT Get list name

OBJECT Get list name 


 

OBJECT Get list name ( {* ;} objeto {; tipoLista} ) -> Resultado 
Parâmetro Tipo   Descrição
Operador in Se especificado, objeto é um nome de objeto (string). Se omitido, objeto é uma variável ou campo.
objeto  Objeto de formulário in Nome de objeto (se * for especificado) ou Variável ou campo (se * for omitido)
tipoLista  Inteiro longo in Tipo de lista: lista de seleção, lista de obrigatórios ou lista de excluídos
Resultado  Texto in Nome da lista de escolha (especificado no modo Desenho)

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 ":

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 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

 
PROPRIEDADES 

Produto: 4D
Tema: Objetos (Formulários)
Número 1072

 
HISTÓRIA 

Criado por: 4D v12
Modificado: 4D v14
Renomear: 4D v14

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)