4D v14.3

FORM GET NAMES

Página Inicial

 
4D v14.3
FORM GET NAMES

FORM GET NAMES 


 

FORM GET NAMES ( {tabela ;} arrayNome {; filtro {; marcador}}{; *} ) 
Parâmetro Tipo   Descrição
tabela  Tabela in Referencia de tabela
arrayNome  Array texto in Arrays de nomes de formulário
filtro  Texto in Filtro de nomes
marcador  Inteiro longo in Marcador para versão mínima a devolver
in Novo valor
Operador in Se passa = o comando é aplicado a base local quando é executado desde um componente(parâmetro ignorado fora deste contexto)

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.

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;*)

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;*)

 
PROPRIEDADES 

Produto: 4D
Tema: Accesso aos Objetos de Design
Número 1167

 
HISTÓRIA 

New
Criado por: 4D v13
Modificado: 4D v14

 
VER TAMBÉM 

METHOD GET PATHS FORM

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)

Inherited from : FORM GET NAMES ( 4D v13.5)