4D v15

FORM GET OBJECTS

Página Inicial

 
4D v15
FORM GET OBJECTS

FORM GET OBJECTS  


 

 

FORM GET OBJECTS (arrayObjetos{;arrayVariaveis{;arrayPag}} {; * | opcaoPag} )

ParâmetroTipoDescrição
arrayObjetosArray cadeia<-Nome de objetos do formulário    
arrayVariaveisArray ponteiro<-Ponteiros as variáveis ou campos associados com objetos     
arrayPagArray inteiro<-Número de página de cada objeto    
* | opcaoPagOperador | Inteiro longo->Se passar * = reduzir a página atual ou
1=Página atual do formulário, 2=Todas as páginas, 4=Páginas herdadas

Originalmente introduzido em 4D v14 R2

O comando FORM GET OBJECTS (tema "Formulários") aceita o novo parâmetro opcional opcionPag que lhe permite designar a ou as parte(s) do formulário desde onde se obtém os objetos.

Por padrão, se o parâmetro opcaoPag é omitido (assim como o parâmetro *), os objetos de todas as páginas, incluindo os objetos herdados, se devolvem (como nas versões anteriores de 4D).

Para reduzir o alcance do comando, pode passar um valor em opcaoPag. Pode passar uma (ou uma combinação) das seguintes constantes, que se encontram no tema "Objetos de formulário (Acesso)":

ConstanteTipoValorDescrição
Form current pageInteiro longo1devolve todos os objetos da página atual, incluindo a página 0, excluindo os objetos herdados
Form all pagesInteiro longo2devolve todos os objetos de todas as páginas, sem contar os objetos herdados
Form inheritedInteiro longo4[devolve unicamente os objetos herdados


Nota: passar o parâmetro * é equivalente a passar a página atual Form current page+Form inherited. A sintaxe utilizando o parâmetro * agora é obsoleta e não deve ser utilizado.

Você quer receber informação sobre todas as páginas, incluindo objetos do formulário herdado (se existir):

  //Formulário aberto
 FORM GET OBJECTS(arrayObjetos;arrayVariaveis;arrayPaginas)

O:

  //Formulário carregado
 FORM LOAD([Tabela1];"MeuForm")
 FORM GET OBJECTS(arrayObjetos;arrayVariaveis;arrayPaginas;Form all pages+Form inherited)

Você deseja obter os objetos da página atual do formulário carregado, incluindo a página 0 do formulário e os objetos dos formulários herdados (se existir):

 FORM LOAD("MiForm")
 FORM GOTO PAGE(2)
 FORM GET OBJECTS(arrayObjetos;arrayVariaveis;arrayPag;Formulario página atual+Formulário herdado)

Quer obter informação sobre todos os objetos no formulário herdado (se os houver). Se não há formulários herdados, os arrays se devolverão vazios.

 FORM LOAD("MiForm")
 FORM GET OBJECTS(arrayObjetos;arrayVariaveis;arrayPag;Formulário herdado)

Você quer obter os objetos da página 4, incluindo os da página 0, mas sem os objetos de formulários herdados (se existir):

 FORM LOAD([Tabela1];"MeuForm")
 FORM GOTO PAGE(4)
 FORM GET OBJECTS(arrayObjetos;arrayVariables;arrayPag;Formulario página actual)

Você quer obter informação dos objetos de todas as páginas, mas sem objetos de formulário herdado (se existissem):

 FORM LOAD([Tabela1];"MeuForm")
 FORM GET OBJECTS(arrayObjetos;arrayVariaveis;arrayPaginas;Form todas as páginas)

 
PROPRIEDADES 

Produto: 4D
Tema: Language

 
HISTÓRIA 

 
ARTICLE USAGE

4D v15 - Update (edição standard) ( 4D v15)