4D v16.3

OBJECT Get pointer

Página Inicial

 
4D v16.3
OBJECT Get pointer

OBJECT Get pointer 


 

OBJECT Get pointer {( seletor {; nomeObjeto {; nomeSubformulario}})} -> Resultado 
Parâmetro Tipo   Descrição
seletor  Inteiro longo in Categoria objeto
nomeObjeto  Texto in Nome do objeto
nomeSubformulario  Texto in Nome de objeto de subformulário
Resultado  Ponteiro in Ponteiro à variável de objeto

O comando OBJECT Get pointer retorna um ponteiro à variável de um objeto de formulário.

Este comando pode ser utilizado para designar diferentes tipos de objetos em função do valor do parâmetro seletor. Pode passar neste parâmetro uma das próximas constantes (do tema "Objetos de formulário (Acesso)"):

  • Object current  ou seletor omitido: se for omitido o parâmetro seletor ou passar este seletor, o comando retorna um ponteiro a a variável associada ao objeto atual (objeto cuyo método está em execução).
    Nota
    : este funcionamento é estritamente equivalente ao funcionamento previo do comando Self. O comando Self se conserva apenas por razões de compatibilidade.
  • Object with focus: se passar este seletor, o comando retorna um ponteiro a variável associada ao objeto que tem o foco no formulário. Os últimos dos parâmetros opcionais são ignorados se forem passados.
    Nota
    : este funcionamento é estritamente equivalente ao comando Focus object. Esse comando agora é obsoleto a partir de 4D v12.
  • Object subform container: se passar este seletor, o comando retorna um ponteiro a variável vinculada com o container do subformulário. Os últimos dois parâmetros opcionais são ignorados se forem passados. Este seletor portanto só pode ser utilizado no contexto de um formulário que é utilizado como um subformulário, com o objetivo de acessar  à variável associada ao objeto contentor.
  • Object named: se passar este seletor, também deve passar o segundo parâmetro, nomObjeto. Neste caso, o comando retorna um ponteiro à variável associada ao objeto cujo nome foi passado neste parâmetro.
    Nota: se nomObjeto corresponde a um subformulário e a opção "Subformulário saída" estiver selecionada, o comando retorna um ponteiro a tabela do sub-formulário se uma tabela fonte estiver especificada, do contrário retorna Nil.

O parâmetro opcional nomeSubform permite recuperar um ponteiro a um objeto nomObjeto que não pertence ao contexto atual, ou seja, ao formulário pai. Para poder utilizar este parâmetro, deve ter passado o seletor Object named.
Quando for passado o parâmetro nomSubForm, o comando OBJECT Get pointer primeiro procura o objeto subformulário objeto chamado nomSubForm no formulário atual, depois busca no interior deste subformulário um objeto chamado nomObjeto. Se este objeto for encontrado,  um ponteiro é retornado à variável deste objeto.

Exemplo  

Dado um formulário "SF" utilizado duas vezes como sub-formulário no mesmo formulário pai. Os objetos sub-formulários são chamados "SF1" e "SF2". O formulário "SF" contém um objeto chamado ValorAtual. No evento "On Load" do método de formulário do formulário pai, queremos inicializar o objeto Valor Atual de SF1 em "Janeiro" e o de SF2 em "Fevereiro":

 C_POINTER($Ptr)
 $Ptr:=OBJECT Get pointer(Object named;"Valor atual";"SF1")
 $Ptr->:="Janeiro"
 $Ptr:=OBJECT Get pointer(Object named;"Valor atual";"SF2")
 $Ptr->:="Fevereiro"



Ver também 

Focus object
OBJECT Get name
Objetos (Formulários)
Objetos de formulário (Acesso)
Self

 
PROPRIEDADES 

Produto: 4D
Tema: Objetos (Formulários)
Número 1124

 
HISTÓRIA 

Criado por: 4D v12

 
PALAVRAS CHAVES 

Subform, focus

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)