Métodos SET

Métodos acessíveis utilizando a função _ADVPL_set_property que permite alterar e manipular os valores do componente.

Método SET: FORM_NAME 

Modificação do formulário.

Sintaxe

_ADVPL_set_property(< l_form_reference >,"FORMINIT_MODIFICATIONPARAMETER",< informaçãoFormulário >, [ Record ], [ Array of Record ])

CHAR

CHAR

CALL _ADVPL_set_property(l_form_reference,"FORM_MODIFICATION","01")

_ADVPL_set_property(< l_form_name >,"FORM_INFO",< formulário >)

Parâmetros

CHAR

CHAR

Se este método não for informado, será utilizada a modificação do formulário no cadastro do metadado (em programas metadado) ou a modificação do 4GL (para programas freeform).

Exemplo

CALL _ADVPL_set_property(l_form_name,"FORM_NAME","LOG5500")

Método SET: FORM_RELEASE 

Release do formulário.

Sintaxe

_ADVPL_set_property(< l_form_reference >,"FORM_RELEASE",< release >)

Parâmetros

CHAR

CHAR

Se este método não for informado, será utilizada a modificação do formulário no cadastro do metadado (em programas metadado) ou a modificação do 4GL (para programas freeform).

Exemplo

CALL _ADVPL_set_property(l_form_reference,"FORM_RELEASE","02")

Método SET: FORM_VERSION 

Versão do formulário.

Sintaxe

_ADVPL_set_property(< l_form_reference >,"FORM_VERSION",< versao >)

Parâmetros

CHAR

CHAR

Se este método não for informado, será utilizada a modificação do formulário no cadastro do metadado (em programas metadado) ou a modificação do 4GL (para programas freeform).

Exemplo

CALL _ADVPL_set_property(l_form_reference,"FORM_VERSION","10")

Método SET: HOTKEY 

Tecla de atalho a ser executada quando a janela da aplicação estiver ativa.

Sintaxe

_ADVPL_set_property(< l_form_reference >,< tecla >,< função >,< descrição >,< componente >, < status >)

Parâmetros

CHAR

CHAR

Importante: para ativar ou desativar um formulário, deverá ter executado previamente o método "PARAMETER" ou "INIT_PARAMETER" para o mesmo.

Exemplo

DATABASE logix GLOBALS
     DEFINE p_user
        LIKE usuarios.cod_usuario
     DEFINE p_cod_empresa LIKE empresa.cod_empresa END GLOBALS DEFINE mr_tela
           RECORD
                              cod_empresa LIKE empresa.cod_empresa,
                              den_empresa LIKE empresa.den_empresa
                          END RECORD DEFINE ma_tela
           ARRAY[100] OF
                          RECORD
                              cod_item LIKE item.cod_item,
                              den_item LIKE item.den_item
                          END RECORD DEFINE m_form_reference
  VARCHAR(100)
#--------------------# 
FUNCTION man100220()
#--------------------#
     # Verifica o acesso do usuário conforme módulo do programa.
     IF  LOG_initApp("PADRAO") <> 0 THEN
         RETURN
     END IF
     INITIALIZE mr_tela.*, ma_tela TO NULL
     LET l_form_reference = _ADVPL_create_component(NULL,"LPARMETADATA")
     CALL _ADVPL_set_property(l_form_reference,"INIT_PARAMETER","man100220",mr_tela,ma_tela)
 END FUNCTION

Para acessar a lista de teclas de atalhos válidas disponíveis, clique aqui.

Exemplo

CALL _ADVPL_set_property(l_form_reference,"HOTKEY","CTRL-I","Incluir um novo registro.",l_menubutton_reference,FALSE)

Método SET: INIT_EVENT 

Adiciona um evento a ser executado ao iniciar a janela da aplicação.

Sintaxe

_ADVPL_set_property(< l_form_reference >,< função>)

Parâmetros

CHAR

CHAR

Este método pode ser chamado mais de uma vez, sendo que as funções serão empilhadas e executadas na ordem em que foram enviadas.

Método SET: MAXIMIZED 

Define se a tela abrirá maximizada.

Sintaxe

_ADVPL_set_property(< l_form_reference >,"MAXIMIZED",ITEM_COUNT", < Associação >, < statusQuantidade >)

Parâmetros

CHAR

CHAR

BOOLEAN

Importante: por padrão no Logix, caso não definido este método, toda janela pai (primeira execução) são abertas maximizadas. As janelas abertas na mesma thread por outras janelas são abertas no modo normal caso o multivalorado possua apenas um campo e não possua associação, deverá ser passado no primeiro parâmetro o nome do campo multivalorado.

Exemplo

CALL _ADVPL_set_property(l_form_reference,"MAXIMIZED",FALSE)

CALL 

Método SET: MAXIMIZED 

Título da janela.

Sintaxe

_ADVPL_set_property(< l_form_reference >,"ITEM_COUNT"," TITLE item",< título>10)

Exemplo

CHAR

CHAR

CALL _ADVPL_set_property(< l_form_reference >,"TITLE","Central do Usuário")

PARAMETER",< Formulário >, [ Record ], [ Array of Record ])

Parâmetros

CHAR

CHAR

Importante: a ordem das variáveis deve ser sempre a mesma, independente do formulário ter ou não campos monovalorados ou multivalorados, primeiro o RECORD para os campos monovalorados e depois o ARRAY OF RECORD para os campos multivalorados.

Exemplo

CALL _ADVPL_set_property(l_form_reference,"PARAMETER","man10022",mr_tela,ma_tela)

Método SET: VALID 

Evento executado quando o usuário fechar a janela de diálogo.

Sintaxe

_ADVPL_set_property(< funçao >)

Parâmetros

CHAR

Importante: este evento é executado tanto na chamada do método ACTIVATE (para desativar a janela de diálogo), quanto no fechamento da janela pelo sistema operacional (pelo X da janela de diálogo). Este evento não é o mesmo evento definido no método EVENT para o botão LQuitButton.

Importante: