4D Doc Center : FORM GET NAMES

4D v13.4

FORM GET NAMES


FORM GET NAMES ( {tabela ;} arrayNoms {; filtro}{; *} )

Parâmetro	Tipo	Descrição
tabela	Tabela	Referencia de tabela
arrayNoms	Array texto	Arrays de nomes de formulário
filtro	Texto	Filtro de nomes
*	Operador	Se passa = o comando é aplicado a base local quando é executado desde um componente(parâmetro ignorado fora deste contexto)

Descrição

O comando FORM GET NAMES enche o array arrayNoms com os nomes dos formulários da aplicação.

Se o parâmetro tabela passa, o comando devolve os nomes dos formulários tabela associados a esta tabela. Caso este parâmetro se omite, o comando devolve os nomes dos formulários projeto da base.

Pode limitar esta lista de formulários passando uma cadeia de comparação no parâmetro filtro: neste caso, somente se devolvem os formulários cujos nomes correspondem ao filtro. Pode utilizar o caracter @ para definir os filtros de tipo "começa por", "termina em" ou "contém". Se passa uma cadeia vazia, se ignora o parâmetro filtro.

Se o comando se executa desde um componente, devolve por defeito os nomes dos formulários projeto do componente. Se o parâmetro passa *, o array conterá os formulários da base local.

Nota: os formulários localizados no lixo não são listados.

Exemplo

Exemplos de uso típico:

  // Lista de todos os formulários projeto da base

 FORM GET NAMES(arr_Names)

 

  // Lista de formulários da tabela [Empregados]

 FORM GET NAMES([Empregados] ;arr_Names)

 

  // Lista de formulários "input" da tabela [Empregados]

 FORM GET NAMES([Empregados] ;arr_Names;"input_@")

 

  // Lista de formulários projeto específicos da base

 FORM GET NAMES(arr_Names;"dialogue_@")

 

  // Lista de formulários tabela desde um componente

  // Um ponteiro é necessário porque o nome da tabela é desconhecido

 FORM GET NAMES(tablePtr->;arr_Names;*)