4D Doc Center : FORM GET NAMES

4D v14.3

FORM GET NAMES


FORM GET NAMES ( {tabela ;} arrayNome {; filtro {; marcador}}{; *} )

Parâmetro	Tipo	Descrição
tabela	Tabela	Referencia de tabela
arrayNome	Array texto	Arrays de nomes de formulário
filtro	Texto	Filtro de nomes
marcador	Inteiro longo	Marcador para versão mínima a devolver
		Novo valor
*	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 caractere @ 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.

Também pode limitar a lista de formulários utilizando o parâmetro opcional marcador, que permite limitar os formulários devolvidos em arrayNome aos que foram modificados depois de um tempo determinado. Como parte de um sistema de controle de versões, este parâmetro lhe permite atualizar só os formulários que foram modificados desde a última cópia de segurança.

Este princípio funciona desta forma: 4D mantém um contador interno das modificações dos recursos da base. Como os formulários são recursos, cada vez que um formulário é criado ou salvo, o contador é incrementado.
Se passar o parâmetro marcador, o comando devolve, em arrayNome, só os formulários que correspondem aos valores dos marcadores superiores ou iguais ao marcador. Além disso, se passar uma variável no marcador, o comando devolve o novo valor do contador de modificação, ou seja, o mais alto, nesta variável. Pode guardar este valor e utilizar ele na próxima chamada ao comando FORM GET NAMES para recuperar só os formulários novos ou modificados.

Se o comando se executa desde um componente, devolve por padrão 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 1

Exemplos de usos típicos:

  // 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 todos os formulários projeto que foram modificados desde a última sincronização

  // vMarker contém um valor numérico

 FORM GET NAMES(arr_Names;"";vMarker)

 

  // Lista de formulários tabela desde um componente

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

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

Exemplo 2

Exemplos de usos típicos:

  // 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 todos os formulários projeto que foram modificados desde a última sincronização

  // vMarker contém um valor numérico

 FORM GET NAMES(arr_Names;"";vMarker)

 

  // Lista de formulários tabela desde um componente

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

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