Linha Logix

Páginas filhas
  • 3. _ADVPL_get_component

Recupera o objeto ADVPL a partir de seu código de referência.

(seleção) Esta função pode ser utilizada para identificar quando o objeto já foi criado/instanciado, caso seja passado um nome fixo na ação advpl _ADVPL_create_component(<nome_referencia>,<classe>), pois se o retorno desta função for NULL, indica que o componente ainda não foi criado ou já foi destruído.

Sintaxe

_ADVPL_get_component( <component_reference> ) -> ADVPL OBJECT

Parâmetros

Nome

Tipo

Descrição

Obrigatório?

component_reference

CHAR

Nome ou código de referência do componente FreeForm instanciado/criado no acionamento da função _ADVPL_create_component()

Sim

Retorno

Tipo

Descrição

ADVPL OBJECT

Retorna a instância de um objeto ADVPL que não pode ser utilizado em código 4GL, no entanto, pode-se utilizar esse retorno para identificar se o valor é NULL com objetivo de avaliar se o objeto já foi instanciado/criado.

Exemplo

#---------------------------------#
 FUNCTION ADVPL_getComponent_test()
#---------------------------------#
   CALL _ADVPL_create_component("meudialog","LDIALOG")

   IF _ADVPL_get_component("meudialog") IS NULL THEN
      CALL conout("Componente meudialog ainda não criado.")
   ELSE
      CALL conout("Componente meudialog já criado.")
   END IF

   IF _ADVPL_get_component("meudialog01") IS NULL THEN
      CALL conout("Componente meudialog01 ainda não criado.")
   ELSE
      CALL conout("Componente meudialog01 já criado.")
   END IF
 END FUNCTION