01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Prever chamada de gatilho de função acionada antes do evento ACTIVATE de cada janela de Diálogo (componente LDIALOG) acionado durante a execução de programa FreeForm ou Metadado, com objetivo de ajustar comportamento ou até desabilitar ou ocultar componentes da janela.

03. SOLUÇÃO

Toda janela de diálogo, construída pelo Metadado ou modelo Freeform, usando o componente LDIALOG, tem uma propriedade chamada FORM_NAME, que é automaticamente para formulários metadado com o valor sendo o nome do formulário e para modelos FreeForm geralmente assume o nome do programa principal ou do último formulário metadado em execução. Mas esta propriedade pode também ser definida pelo código do programa usando a função _ADVPL_set_property(<referência_ldialog>,"FORM_NAME",<nome_desejado_form>).

Se no código fonte 4GL for desenvolvida uma função assim:

         FUNCTION <FORM_NAME>_before_activate_dialog()

Onde <FORM_NAME> é o valor da propriedade FORM_NAME da janela de diálogo acionada, a função é automaticamente detectada e acionada. No código dessa função será possível obter a referencia da janela de diálogo atual e manipular componentes quando houver necessidade ou até mesmo realizar outras operações antes da abertura desta janela.

O nome da janela de diálogo corrente pode ser recuperado pela função _ADVPL_FREEFORM_getLastFormReference().

04. DEMAIS INFORMAÇÕES

Não se aplica.

05. ASSUNTOS RELACIONADOS

• Não se aplica.