Páginas filhas
  • LGX - LParMetaData

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Pagetitle
LGX - LParMetaData
LGX - LParMetaData
Componente abstrato, base dos componentes para criação de janelas de aplicações. Todos os métodos contidos neste componente poderão ser executados pelos componentes que o herdamque cria e executa formulário metadado de processamento.

Atualmente estes formulários são cadastrados utilizando o programa "FRM0003 - FORMULÁRIOS DE PARÂMETROS/PROCESSAMENTO".


Hierarquia



Métodos GET


Métodos acessíveis utilizando a função _ADVPL_get_property, que permite recuperar e manipular os valores do componente: 


Exemplo

Expandir
titleGET ACTIVATECOMPONENT_REFERENCE

Método GET:

ACTIVATE

COMPONENT_REFERENCE

Referência do componente de um determinado campo do formulárioRetorna se a janela da aplicação está ativada.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"ACTIVATE"COMPONENT_REFERENCE", < Tabela >, < Coluna >) ==> BOOLEANReferência

Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference 
CHAR

Referência do formulário.

Sim
Retorno
Tabela

Tipo

Descrição

BOOLEANIndicador que define se a janela está ativada.
CHARNome da tabela da coluna do formulário da qual deseja-se recuperar a referência do componente.Sim
ColunaCHARNome da coluna do formulário da qual deseja-se recuperar a referência do componente.Sim


Retorno



Tipo

Descrição

CHAR

Referência do componente de um campo do formulário.

Exemplo



Bloco de código
languageruby
Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_component_activatereference = _ADVPL_get_property(l_form_reference,"ACTIVATECOMPONENT_REFERENCE","item","cod_empresa")




Expandir
titleGET COMPONENTCURRENT_FOCUS_REFERENCEOPERATION

Método GET:

COMPONENT

CURRENT_

FOCUS_REFERENCE

OPERATION

Operação em execução

Referência do componente em foco.

Sintaxe



Bloco de código
_ADVPL_get_property(< ml_form_reference >,"COMPONENTCURRENT_FOCUS_REFERENCEOPERATION") ==> ReferênciaOperação

Parâmetros



NomeTipoDescriçãoObrigatório?
ml_form_reference
CHAR

Referência do formulário.

Sim

Retorno



Tipo

Descrição

CHAR
Referência do componente

Nome da operação que está em

foco na tela

execução, conforme cadastrada no programa "FRM0001 - Barra de Ferramentas".

Exemplo



Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_componentcurrent_referenceoperation = _ADVPL_get_property(ml_form_reference,"COMPONENTCURRENT_FOCUS_REFERENCEOPERATION")




Altura da janela da aplicação
Expandir
titleGET CONTAINEREXECUTE_HEIGHTOPERATION

Método GET:

CONTAINER

EXECUTE_

HEIGHT

OPERATION

Executa uma determinada operação do formulário, conforme cadastrada no programa "FRM0001 - Barra de Ferramentas"

Altura da janela da aplicação.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"CONTAINEREXECUTE_HEIGHT"OPERATION", < Operação >) ==> Altura
Dica
titleObs:
Para retornar a largura correta da janela da aplicação é necessário antes efetuar a chamada do método REFRESH_SIZE.
Situação


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
()CHAR

Referência do formulário.

Sim
OperaçãoCHARNome da operação do formulário da qual deseja-se executar, conforme cadastrada no programa "FRM0001 - Barra de Ferramentas".Sim

Retorno



Tipo

Descrição

( )
BOOLEAN

Caso a operação foi executado com sucesso retornará verdadeiro, caso contrário retornará falso.

Exemplo



Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_container_heightstatus = _ADVPL_get_property(l_form_reference,"CONTAINER_HEIGHTEXECUTE_OPERATION","inform")




Largura da janela da aplicação
Expandir
titleGET CONTAINER_WIDTHINFORMED

Método GET:

CONTAINER_WIDTH

INFORMED

Verificação se os parâmetros do formulário já foram informados ou não no formulárioLargura da janela da aplicação.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"CONTAINER_WIDTHINFORMED") ==> Largura
Dica
titleObs:
Para retornar a largura correta da janela da aplicação é necessário antes efetuar a chamada do método REFRESH_SIZE.
informou?


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
()CHAR

Referência do formulário.

Sim

Retorno



Tipo

Descrição

( )
BOOLEAN

Indicador que define se os parâmetros do formulário já foram informados ou não no formulário.

Exemplo



Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_container_widthinformed = _ADVPL_get_property(l_form_reference,"CONTAINER_WIDTHINFORMED")




Expandir
titleGET FORMITEM_INFOCOUNT

Método GET:

FORM

ITEM_

INFO

COUNT

Quantidade de linhas de um determinado multivalorado do

Breve informação sobre o formulário.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"FORMITEM_INFO"COUNT",  < Associação >) ==> InformaçãoQuantidade


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim

Retorno

AssociaçãoCHARNome da associação do multivalorado do formulário da qual deseja-se retornar o número de linhas.Sim

Retorno



Tipo

Descrição

( )

Número de linhas informadas no multivalorado do formulário

CHAR

Largura da janela da aplicação.

Exemplo



Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_formitem_infocount = _ADVPL_get_property(l_form_reference,"FORM_INFOITEM_COUNT","item")




Expandir
titleGET FORMLABEL_MODIFICATIONREFERENCE

Método GET:

FORM

LABEL_

MODIFICATION 

REFERENCE

Modificação do formulário.Referência do componente da descrição de um determinado campo do formulário.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"FORMLABEL_MODIFICATION"REFERENCE",  < Tabela >, < Coluna >) ==> ModificaçãoReferência


Parâmetros



Tipo
NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim

Retorno

Tabela

Descrição

CHAR
Modificação
Nome da tabela da coluna do formulário da qual deseja-se recuperar a referência da descrição.
Exemplo
Sim
code
ColunaCHARNome da coluna do formulário da qual deseja-se recuperar a referência da descrição.Sim

Retorno



Tipo

Descrição

CHAR

Referência do componente de descrição de um campo do formulário.

Exemplo



Bloco de código
languageruby
themeEclipse
languageruby
themeEclipse
linenumberstrue
LET l_formlabel_modificationreference = _ADVPL_get_property(l_form_reference,"FORM_MODIFICATIONLABEL_REFERENCE","item","cod_empresa")




Expandir
titleGET FORMMENU_NAMEBUTTON_REFERENCE

Método GET:

FORM

MENU_BUTTON_

NAME

REFERENCE

Referência de um botão da barra de ferramentas

Nome do formulário.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"FORMMENU_BUTTON_NAME"REFERENCE", < Operação >) ==> FormulárioReferência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim
Retorno
Operação

Tipo

Descrição

CHARNome da operação, cadastrada no programa "FRM0001 - Barra de Ferramentas", do formulário da qual deseja-se retornar a referência.
Exemplo
Sim
code

Retorno



Tipo

Descrição

CHAR

Referência de um botão da barra de ferramentas (LMenuButton) correspondente à operação informada como parâmetro.

Exemplo



Bloco de código
languagelanguageruby
themeEclipse
linenumberstrue
LET l_formmenubutton_namereference = _ADVPL_get_property(l_form_reference,"FORM_NAMEMENU_BUTTON_REFERENCE","inform")




Expandir
titleGET FORMMENUBAR_RELEASEREFERENCE

Método GET:

FORM

MENUBAR_

RELEASE

REFERENCE

Referência da barra de ferramentas

Release do formulário.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"FORMMENUBAR_RELEASEREFERENCE") ==> ReleaseReferência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim

Retorno



Tipo

Descrição

CHAR

Release do Referência da barra de ferramentas (LMenuBar) do formulário.

Exemplo



Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_menubar_releasereference = _ADVPL_get_property(l_form_reference,"FORMMENUBAR_RELEASEREFERENCE")




Expandir
titleGET FORM_VERSIONMULTI_VALUED_BUTTON_REFERENCE

Método GET:

FORM_VERSION 

MULTI_VALUED_BUTTON_REFERENCE 

Referência do componente do botão de multivalorado de um determinado campo Versão do formulário.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"FORM_VERSION"MULTI_VALUED_BUTTON_REFERENCE",< Tabela >, < Coluna >) ==> VersãoReferência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim

Retorno

TabelaCHARNome da tabela da coluna do formulário da qual deseja-se recuperar a referência do botão de multivalorado.Sim
ColunaCHARNome da coluna do formulário da qual deseja-se recuperar a referência do botão de multivalorado.Sim


Retorno



Tipo

Descrição

CHAR

Referência do componente do botão de zoom de um campo

 ( )

Versão do formulário.

Exemplo



Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_formzoom_button_versionreference = _ADVPL_get_property(l_form_reference,"MULTI_VALUED_BUTTON_REFERENCE","item","FORMcod_VERSIONitem")




Exemplo

Expandir
titleGET INIT_EVENT MULTI_VALUED_COLUMN_REFERENCE

Método GET:

INIT_EVENT 

MULTI_VALUED_COLUMN_REFERENCE

Referência de uma determinada coluna do componente grid do multivalorado em execução no formulárioLista de eventos executados na abertura da janela da aplicação.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"INIT_EVENT"MULTI_VALUED_COLUMN_REFERENCE",< Coluna >) ==> Lista de funçõesReferência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim
Retorno
Coluna

Tipo

Descrição

 ( )

Lista de funções executadas na abertura da janela da aplicação.

CHARNome da coluna do multivalorado em execução no formulário.Sim


Retorno



Tipo

Descrição

CHAR

Referência da coluna do componente grid do multivalorado em execução no formulário.

(informação) Importante: caso não tenha nenhum multivalorado em execução, este método irá retornar nulo.


Exemplo



Bloco de código
languageruby
themeEclipse
Bloco de código
languageruby
themeEclipse
linenumberstrue
LET lal_multivalued_initcolumn_eventreference = _ADVPL_get_property(l_form_reference,"INIT_EVENTMULTI_VALUED_COLUMN_REFERENCE","cod_item")




Exemplo

Expandir
titleGET MAXIMIZED MULTI_VALUED_TABLE_REFERENCE

Método GET:

MAXIMIZED 

MULTI_VALUED_TABLE_REFERENCE

Referência do componente grid do multivalorado em execução no formulárioRetorna se a janela da aplicação está maximizada.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"MAXIMIZEDMULTI_VALUED_TABLE_REFERENCE") ==> Maximizada?Referência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim

Retorno



Tipo

Descrição

BOOLEAN

Indicador que define se a janela da aplicação está maximizada.

CHAR

Referência do componente grid do multivalorado em execução no formulário.

(informação) Importante: caso não tenha nenhum multivalorado em execução, este método irá retornar nulo.

Exemplo



Bloco de código
language
Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_maximizedmultivalued_table_reference = _ADVPL_get_property(l_form_reference,"MAXIMIZEDMULTI_VALUED_TABLE_REFERENCE")




Expandir
titleGET TITLE PROGRESS_BAR_REFERENCE

Método GET:

TITLE

PROGRESS_BAR_REFERENCE

Referência da barra de progresso utilizada na operação de processamento do formulárioTítulo da janela da aplicação.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"TITLEPROGRESS_BAR_REFERENCE") ==> TítuloReferência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim

Retorno



Tipo

Descrição

BOOLEAN
CHAR
Título da janela da aplicação

Referência da barra de progresso utilizada na operação de processamento do formulário.

(informação) Importante: este método deve ser chamado somente na função da operação padrão process do formulário.

Exemplo



Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_titleprogressbar_reference = _ADVPL_get_property(l_form_reference,"TITLEPROGRESS_BAR_REFERENCE")




Expandir

Métodos SET

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



titleGET STATUS_BAR_REFERENCE

Método GET: STATUS_BAR_REFERENCE

Referência da barra de status do formulário

Expandir
titleSET ACTIVATE

Método SET: ACTIVATE

Ativa/Desativa a janela da aplicação.

Sintaxe



Bloco de código
_ADVPL_setget_property(< l_form_reference >,"ACTIVATE", < l_status >)STATUS_BAR_REFERENCE") ==> Referência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim
l_status

Retorno

SMALLINT

Indicador que define se será ativado ou desativado o formulário.

   TRUE - Ativa o formulário

   FALSE - Desativa/Fecha o formulário.

Sim

Tipo

Descrição

CHAR

Referência da barra de status do formulário.

(informação) Para ativar ou desativar um formulário, deverá ter executado previamente o método "FORM" ou "INIT_FORM" para o mesmo.

Exemplo



Bloco de código
languageruby
themeConfluenceEclipse
linenumberstrue
CALLLET l_statusbar_reference = _ADVPL_setget_property(l_form_reference,"ACTIVATE",TRUESTATUS_BAR_REFERENCE")




Expandir
titleSET CENTERGET ZOOM_BUTTON_REFERENCE

Método

SET: CENTER

GET: ZOOM_BUTTON_REFERENCE

Referência do componente do botão de zoom de um determinado campo do formulárioCentraliza a janela da aplicação na área de trabalho do usuário.

Sintaxe



Bloco de código
_ADVPL_setget_property(< l_form_reference >,"CENTER")ZOOM_BUTTON_REFERENCE",< Tabela >, < Coluna >) ==> Referência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim

(informação) 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).

TabelaCHARNome da tabela da coluna do formulário da qual deseja-se recuperar a referência do botão de zoom.Sim
ColunaCHARNome da coluna do formulário da qual deseja-se recuperar a referência do botão de zoom.Sim

Retorno



Tipo

Descrição

CHAR

Referência do componente do botão de zoom de um campo do formulário.

Exemplo



Bloco de código
languageruby
themeConfluenceEclipse
linenumberstrue
CALLLET l_zoom_button_reference = _ADVPL_setget_property(l_form_reference,"CENTER"ZOOM_BUTTON_REFERENCE","item","cod_item")




Exemplo

Expandir
titleSET CENTERED GET ZOOM_REFERENCE

Método

SET

GET:

CENTERED

ZOOM_REFERENCE

Referência do zoom de um determinado campo do formulárioDefine se a tela abrirá no centro da área de trabalho.

Sintaxe



Bloco de código
_ADVPL_setget_property(< l_form_reference >,"CENTEREDZOOM_REFERENCE",< l_statusTabela >, < Coluna >) ==> Referência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim
l_status
Tabela
BOOLEAN
Indicador que define se a tela será aberta no centro da área de trabalho do usuário.
CHARNome da tabela da coluna do formulário da qual deseja-se recuperar a referência do zoom.Sim
ColunaCHARNome da coluna do formulário da qual deseja-se recuperar a referência do zoom.Sim

Retorno



Tipo

Descrição

CHAR

Referência do zoom de determinado campo do formulário.

Exemplo



Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_zoom_reference = _ADVPL_get
Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"CENTEREDZOOM_REFERENCE","item",TRUE"cod_item")





Métodos SET

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


Expandir
titleSET ACTIVATE
Expandir
titleSET ENABLE_ESC_CLOSE

Método SET:

ENABLE_ESC_CLOSE

 ACTIVATE

Ativa/Desativa a janela da aplicaçãoDefine se habilita o encerramento da janela com a tecla ESC.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_form_reference >,"ENABLE_ESC_CLOSEACTIVATE", < l_status >)

Parâmetros



a janela poderá ser encerrada com a tecla ESC.
NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR
Referência do formulário.Sim
l_statusBOOLEAN

Indicador que define se

Sim

será ativado ou desativado o formulário.

   TRUE - Ativa o formulário

   FALSE - Desativa/Fecha o formulário.

Sim

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

Exemplo



Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"ENABLE_ESC_CLOSEACTIVATE",FALSETRUE)




Expandir
titleSET FORM_INFO ENABLE_VALID_DUPLICATE_VALUES

Método SET:

FORM_INFO 

ENABLE_VALID_DUPLICATE_VALUES

Habilita/desabilita a validação de valores duplicados no(s) multivalorado(s) do formulárioDefine se habilita o encerramento da janela com a tecla ESC.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_form_reference >,"FORM_INFOENABLE_VALID_DUPLICATE_VALUES",< informaçãoHabilita? >)

Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR
Referência do formulário.Sim
informaçãoHabilita?
CHAR
Breve informação sobre o formulário.Sim

(informação) 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).

BOOLEANIndicador que define se será habilitada ou desabilitada a validação de valores duplicados no(s) multivalorado(s) do formulário.Sim


Exemplo



Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"FORM_INFO","Formulário de manutenção de usuário Logix."ENABLE_VALID_DUPLICATE_VALUES",FALSE)




Expandir
titleSET FORM_MODIFICATION INFORMED

Método SET:

FORM_INFO 

INFORMED

Força a definição da verificação se os parâmetros do formulário já foram informados ou não no formulário. Utilizados em casos e que o formulário é carregado manualmente.Modificação do formulário.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_form_reference >,"FORM_MODIFICATIONINFORMED",< informação informou?>)

Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR
Referência do formulário.Sim
informaçãoJá informou?
CHAR
Breve informação sobre o formulário.Não

(informação) 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

BOOLEAN
Indicador que força a definição de verificação se os parâmetros foram ou não informados no formulário.Sim


Exemplo



Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"FORM_MODIFICATIONINFORMED","01"TRUE)




Método SET: FORM_RELEASE 

Release do formulário.

Sintaxe

Expandir
titleSET FORMINIT_NAME PARAMETER

Método SET:

FORM

INIT_

NAME 

PARAMETER

Junção dos métodos "PARAMETER" e "ACTIVATE", carrega as informações do formulário e executa-o em seguida

Modificação do formulário.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_form_namereference >,"FORMINIT_INFOPARAMETER",< formulárioFormulário >, [ Record ], [ Array of Record ])

Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_namereference
CHAR
Referência do formulário.Sim
formulárioFormulário 
CHAR
Nome do formulário cadastrado no programa "FRM0003 - Formulários de Parâmetros/Processamento".Sim

(informação) 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

Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_name,"FORM_NAME","LOG5500")
Expandir
titleSET FORM_RELEASE
Bloco de código
_ADVPL_set_property(< l_form_reference >,"FORM_RELEASE",< release >)

Parâmetros

NomeTipoDescriçãoObrigatório?l_form_reference
CHAR
Referência do formulário.Simrelease
CHAR
Release do formulário.Sim

(informação) 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

Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"FORM_RELEASE","02")
Expandir
titleSET FORM_VERSION

Método SET: FORM_VERSION 

Versão do formulário.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_form_reference >,"FORM_VERSION",< versao >)

Parâmetros

NomeTipoDescriçãoObrigatório?l_form_reference
CHAR
Referência do formulário.Simversao
CHAR
Versão do formulário.Sim

(informação) 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

Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"FORM_VERSION","10")
Expandir
titleSET HOTKEY

Método SET: HOTKEY 

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

Sintaxe

Bloco de código
_ADVPL_set_property(< l_form_reference >,< tecla >,< função >,< descrição >,< componente >, < status >)

Parâmetros

RecordRECORDVariável RECORD que irá controlar o conteúdo dos campos monovalorados do formulário.Sim
Array of RecordARRAY OF RECORDVariável ARRAY OF RECORD que irá controlar o conteúdo dos campos multivalorados do formulário.Sim

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


Exemplo



Bloco de código
languageruby
themeConfluence
linenumberstrue
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




(informação) Para acessar a lista de teclas de atalhos válidas disponíveis, clique aqui.

Exemplo

Expandir
titleSET ITEM_COUNT

Método SET: ITEM_COUNT

Quantidade de linhas de um determinado multivalorado do formulário

NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR
Referência do formulário.Sim
tecla
CHAR
Tecla de atalho conforme teclas disponíveis na lista de teclas de atalhos.Sim
funçãoCHARFunção que será executada ao acionar a tecla de atalho.Sim
descriçãoCHARDescrição da execução da tecla de atalho, esta descrição será exibida na janela de tecla disponíveis no formulário para o usuário.Sim
componenteCHARReferência do componente do qual pertence a tecla de atalho.Não
statusBOOLEANIndicador lógico que define se o atalho deverá ser executado sempre ou somente quando o componente informado no método estiver focado em tela.Não
Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"HOTKEY","CTRL-I","Incluir um novo registro.",l_menubutton_reference,FALSE)
Expandir
titleSET INIT_EVENT

Método SET: INIT_EVENT 

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

Sintaxe

Bloco de código
_ADVPL_set_property(< l_form_reference >,< função>)

Parâmetros

NomeTipoDescriçãoObrigatório?l_form_reference
CHAR
Referência do formulário.Simfunção
CHAR
Função executada executada ao iniciar a janela de aplicação.Sim

(informação) 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.

Expandir
titleSET MAXIMIZED

Método SET: MAXIMIZED 

Define se a tela abrirá maximizada.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_form_reference >,"MAXIMIZEDITEM_COUNT", < statusAssociação >, < Quantidade >)

Parâmetros



NomeTipoDescriçãoObrigatório??
l_form_reference
CHAR
Referência do formulário.Sim
 Associação 
CHAR
Nome da associação do multivalorado l_form_reference
CHAR
Referência do formulário.Sim
statusQuantidadeBOOLEANINTEGERIndicador que define se a janela abrirá maximizadaNúmero de linhas que será atribuído para um determinado multivalorado do formulário.Sim

(informação) 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



Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"MAXIMIZED",FALSE)
Expandir
titleSET TITLE

Método SET: MAXIMIZED 

Título da janela.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_form_reference >,"ITEM_COUNT"," TITLE item",< título>10)
Parâmetros




Nome

Exemplo

Expandir
titleSET PARAMETER

Método SET: PARAMETER

Carrega as informações do formulário, mas não o executa. Utilizado em casos em que é necessário carregar o formulário e após isso executar diretamente uma operação do mesmo.

Sintaxe



Bloco de código
TipoDescriçãoObrigatório?
l_form_reference
CHAR
Referência do formulário.Sim
título
CHAR
Título da janela.Sim
Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(< l_form_reference >,"TITLE","Central do Usuário")
Expandir
titleSET VALID
PARAMETER",< Formulário >, [ Record ], [ Array of Record ])

Parâmetros



NomeTipoDescriçãoObrigatório?
 l_form_reference 
CHAR
Referência do formulário.Sim
Formulário 
CHAR
Nome do formulário cadastrado no programa "FRM0003 - Formulários de Parâmetros/Processamento".Sim
RecordRECORDVariável RECORD que irá controlar o conteúdo dos campos monovalorados do formulário.Não
Array of RecordARRAY OF RECORDVariável ARRAY OF RECORD que irá controlar o conteúdo dos campos multivalorados do formulário.Não

(informação) 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



Bloco de código
languageruby
themeConfluence
linenumberstrue
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

Bloco de código
_ADVPL_set_property(< funçao >)

Parâmetros

NomeTipoDescriçãoObrigatório?função
CHAR
Função que será executada quando o usuário fechar a janela de diálogo.Sim

(informação) 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.

(informação)Importante: caso a função informada neste método retornar falso, a tela não será finalizada.