METHOD RESOLVE PATH

METHOD RESOLVE PATH ( rota ; tipoMetodo ; prtTabela ; nomObjeto ; nomObjetoForm {; *} )

Parâmetro	Tipo		Descrição
rota	Text	→	Rota a resolver
tipoMetodo	Integer	←	Seletor tipo de objeto
prtTabela	Pointer	←	Referência de tabela
nomObjeto	Text	←	Nome de formulário ou método de base
nomObjetoForm	Text	←	Nome de objeto de formulário
*	Operador	→	Se passado = o comando se aplica à base local quando se executa desde um componente (parâmetro ignorado fora deste contexto)

Descrição

O comando METHOD RESOLVE PATH analisa a rota de acesso interna passada no parâmetro rota e devolve seus diferentes componentes nos parâmetros tipoMetodo, ptrTabela, nomObjeto e nomObjetoForm.

No parâmetro tipoMetodo devolve um valor que indica o tipo do método. Pode comparar este valor com as seguintes constantes do tema Design Object Access:

Constante	Tipo	Valor	Comentário
Path database method	Inteiro longo	2
Path project form	Inteiro longo	4	Rota dos métodos formulário projeto e de todos seus métodos objeto. Exemplos: [projectForm]/myForm/{formMethod} [projectForm]/myForm/button1 [projectForm]/myForm/mylist [projectForm]/myForm/button1
Path project method	Inteiro longo	1	Nome do método. Exemplo: MeuMétodoProjeto
Path table form	Inteiro longo	16	Rota dos métodos formulário tabela e de todos seus métodos objeto. Exemplos: [tableForm]/table_1/Form1/{formMethod} [tableForm]/table_1/Form1/button1 [tableForm]/table_1/Form1/mylist [tableForm]/table_2/Form1/mylist
Path trigger	Inteiro longo	8	Rota dos triggers da base. Exemplos: [trigger]/tabela_1 [trigger]/tabela_2

Nota: O comando não verifica se o método realmente existe no banco de dados ou projeto. Um erro só é gerado se um nome de tabela inválido for passado

O parâmetro ptrTabla contém um ponteiro a uma tabela da base quando a rota referencia um método formulário tabela ou um trigger.

O parâmetro nomObjeto contém:

• um nome de formulário se a rota referencia um formulário tabela ou projeto.
• um nome de método base se a rota referencia um método base.

O parâmetro nomObjetoForm contém um nome de objeto de formulário se a rota referencia um método objeto.

Se o comando se executa desde um componente, considera por padrão que a via designa um método do componente. Se passado o parâmetro *, se considera que a via designa um método da base local.

Exemplo 1

Resolução de uma rota de método base:

 var $methodType : Integer
 var $tablePtr : Pointer
 var $objectName : Text
 var $formObjectName : Text
 
 METHOD RESOLVE PATH("[databaseMethod]/onStartup";$methodType;$tablePtr;$objectName;$formObjectName)
  // $methodType: 2
  // $tablePtr: Nil pointer
  // $objectName: "onStartup"
  // $formObjectName: ""

Exemplo 2

Resolução de uma rota de método de formulário tabela:

 var $methodType : Integer
 var $tablePtr : Pointer
 var $objectName : Text
 var $formObjectName : Text
 
 METHOD RESOLVE PATH("[tableForm]/Table1/output1/myVar1";$methodType;$tablePtr;$objectName;$formObjectName)
  // $methodType: 16
  // $tablePtr: -> [Table1]
  // $objectName: "output1"
  // $formObjectName: "Btn1"

Ver também

METHOD Get path

Propriedades

Número do comando	1165
Thread-seguro	✗