4D v14.3

METHOD GET PATHS FORM

Página Inicial

 
4D v14.3
METHOD GET PATHS FORM

METHOD GET PATHS FORM 


 

METHOD GET PATHS FORM ( {aTabela ;} arrRotas {; filtro}{; marcador}{; *} ) 
Parâmetro Tipo   Descrição
aTabela  Tabela in Referência de tabela
arrRotas  Array texto in Arrays de rotas e nomes dos métodos
filtro  Texto in Filtros de nomes
marcador  Variável inteiro longo in Valor mínimo de marcador
in Novo valor atual
Operador in Se passado = o comando se aplica à base local quando se executa desde um componente (parâmetro ignorado fora deste contexto)

O comando METHOD GET PATHS FORM enche o array arrRotas com as rotas de acesso internas e os nomes dos métodos de todos os objetos dos formulários assim como também dos métodos formulário. Os métodos formulário se etiquetam {formMethod}.

Apenas os objetos que contem código são listados. Por exemplo, os botões que estão associados somente com uma ação padrão não são retornados.

Se você passar o parâmetro aTabela, o comando retorna os objetos dos formulários de tabela associados a esta tabela. Se você omitir esse parâmetro, o comando retorna os objetos de formulários do projeto base.

Você pode limitar esta lista de formulários passando uma cadeia de comparação no parâmetro filtro, neste caso, somente os formulários cujos nomes correspondam ao filtro serão retornados. Você pode usar o caractere @ para definir filtros de tipo "começa por", "termina em" ou "contém". Se você passar uma cadeia vazia de caracteres, o parâmetro filtro é ignorado.

 O parâmetro de marcador permite recuperar métodos de modificação de rotas de um ponto específico. Como parte de um sistema de controle de versão, isso significa que você pode atualizar apenas os métodos alterados desde o último backup.
A operação é a seguinte: 4D mantém um contador de métodos de modificação. Cada vez que um método é criado ou torna-se a manter, esse contador é incrementado e seu valor atual é armazenado no marcador interno do método.
Se você passar o parâmetro marcador, o comando retornará apenas os métodos cuja pontuação for maior ou igual ao valor passado neste parâmetro. Além disso, o comando retorna em marcador o novo valor atual do contador de modificação, ou seja, o valor mais alto. Se você salvar esse valor, pode você pode passá-lo na próxima vez que este comando for chamado assim que você recupera apenas métodos novos ou modificados.

Se você executar esse comando em um componente, retorna por defeito as rotas dos métodos de componente. Se o parâmetro * passa, a matriz conterá as rotas dos métodos da base local.

Nota: o comando não lista os objetos de formulários herdados ou dos sub-formulários.

Se o  comando detecta um nome de método duplicado, é gerado o erro -9802 ("Object path not unique"). Neste caso, é aconselhável utilizar o CSM com o propósito de verificar a estrutura da base de dados.

Lista de todos os objetos do formulário "input" da tabela [Empregados]. Note que os métodos formulário tabela (e os métodos formulário projeto) se processam como objetos que pertencem ao formulário:

 METHOD GET PATHS FORM([Employees];arrPaths;"input")
  // Conteúdo de arrPaths (por exemplo)
  // [tableForm]/input/{formMethod} -> Método formulário
  // [tableForm]/input/bOK -> Método objeto
  // [tableForm]/input/bCancel -> Método objeto

Lista dos objetos do formulário projeto "dial":

 METHOD GET PATHS FORM(arrPaths;"dial")

Lista de todos os objetos dos formulários "input" da tabela [Empregados] a partir de um componente:

 METHOD GET PATHS FORM(([Empregados];arrPaths;"input@";*)

 
PROPRIEDADES 

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

 
HISTÓRIA 

Criado por: 4D v13

 
VER TAMBÉM 

FORM GET NAMES

 
ARTICLE USAGE

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