Este evento corre quando o objeto é criado (por isso mesmo só uma vez).
Este evento é usado para guardar alguns valores no objeto através da propriedade "MeusDados" ou então para modificar algumas propriedades do objeto de maneira a influenciar o seu comportamento.
É muito importante saber que neste evento só se podem referir as propriedades do próprio objeto e do ecrã onde ele está a ser criado, porque não se pode assegurar que os objectos vizinhos já foram criados.
Exemplos:
ObjRecebido.Janela.Caption="Exemplo de Demonstração"
Este código é seguro, enquanto que
ObjRecebido.Objecto.Parent.Obj3.Caption="O texto deste objeto foi alterado"
este código não deve ser utilizado neste evento porque não se sabe se o objeto Obj3 já está criado.
Uma codificação possível de utilizar neste evento é por exemplo:
Nos campos do tipo Memo, o utilizador pode fazer duplo clique de modo a abrir uma janela maior para editar o valor do campo. Esta situação não é possível nos objetos do tipo Campos de ficheiros tipo memo que se podem colocar em páginas de utilizador. Com este tipo de evento é possível atribuir esta funcionalidade a este tipo de objeto, basta colocar a seguinte linha de código:
ObjRecebido.Objecto.odblclickedita=.t.
Esta propriedade está disponível na gama Enterprise, nos seguintes objetos:
Análise Multidimensional
Caixa
Campo em Árvore
Campos de Escolha Seletiva
Campo de Ligação
Campos de Tabelas
Campos com Listas
Campos com Tabelas
Campos Memos
Campos Lógicos
Figura Geométrica
Gráfico
Grelha
Imagem
Linha Diagonal
Linha Horizontal
Linha Vertical
Objeto Análise Avançada em HTML (Apenas disponível se possuir o Módulo Dashboard)
Objeto Indicador (Apenas disponível se possuir o Módulo Dashboard)
Texto