Linha Logix

Páginas filhas
  • 8. _ADVPL_isValidComponent

Avalia se um determinado objeto ADVPL é válido a partir de seu código de referência, ou seja, avalia se o objeto está instanciado em memória.

Sintaxe

_ADVPL_isValidComponent( <component_reference> ) -> BOOLEAN

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 BOOLEAN

Retorna .T. (TRUE) se a referência do objeto estiver instanciado em memória ou .F. (FALSE) se o objeto não foi instanciado ou já foi destruído.

Quando esta função é acionada a partir de um fonte 4GL, o tipo booleano do ADVPL é retornado para o 4GL como TRUE ou FALSE automaticamente, devido a conversão automática da comunicação INTEROP entre ADVPL x 4GL.

Exemplo

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

   IF NOT _ADVPL_isValidComponent("meudialog") THEN
      CALL conout("Componente meudialog ainda não criado.")
   ELSE
      CALL conout("Componente meudialog já criado.")
   END IF

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