4D Doc Center : GET FORM OBJECTS

4D v14.3

GET FORM OBJECTS


GET FORM OBJECTS ( arrObjetos {; arrVariaveis {; arrPags}} {; *} )

Parâmetro	Tipo	Descrição
arrObjetos	Array cadeia	Name of form objects
arrVariaveis	Array ponteiro	Pointers to variables or fields associated with objects
arrPags	Array inteiro	Page number of each object
*	Operador	If passed = reduce to the current page

Descrição

O comando FORM GET OBJECTS retorna em forma de array(s) a lista de todos os objetos presentes no formulário atual da tabela atual. Esta lista pode estar restrita à página atual do formulário. O comando pode ser utilizado com os formulários de entrada e de saída.

Se um array passado como parâmetro não for declarado previamente, o comando o cria e dimensiona automaticamente. Entretanto, pensando na compilação da aplicação, lhe recomendamos declarar explicitamente cada array.

Passe em arrObjetos o nome do array alfa que conterá os nomes dos objetos (cada nome de objeto é único em um formulário). A ordem na qual os objetos aparecem no array não é significativo.

Os outros arrays preenchidos opcionalmente pelo comando são sincronizados com o primeiro array.

Passe no parâmetro opcional arrVariables o nome do array ponteiro que contém os ponteiros às variáveis ou campos associados aos objetos. Se um objeto não tiver uma variável associada, o ponteiro Nil é retornado. Se houver um objeto de tipo “subformulário”, é retornado um ponteiro à tabela do subformulário.

O terceiro array (opcional), arrPags, é preenchido com os números de páginas do formulário. Cada linha deste array contém o número de página do objeto correspondente.
Os objetos que vem de um formulário herdado são considerados como pertencentes à página 0 do formulário atual.

O parâmetro opcional * lhe permite reduzir a lista de objetos retornados na página atual do formulário. Quando se passa este parámetro, só os objetos da página atual, da página 0 e das páginas herdadas são retornados pelo comando. Em outras palavras, todos os objetos presentes na página atual do formulário (visíveis ou não) são processados pelo comando.