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 que 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: 


Expandir
titleGET COMPONENT_REFERENCE

Método GET: COMPONENT_REFERENCE

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

Sintaxe



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

Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference 
CHAR

Referência do formulário.

Sim
TabelaCHARNome 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
themeEclipse
linenumberstrue
LET l_component_reference = _ADVPL_get_property(l_form_reference,"COMPONENT_REFERENCE","item","cod_empresa")




Expandir
titleGET CURRENT_OPERATION

Método GET: CURRENT_OPERATION

Operação em execução.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"CURRENT_OPERATION") ==> Operação

Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim

Retorno



Tipo

Descrição

CHAR

Nome da operação que está em execução, conforme cadastrada no programa "FRM0001 - Barra de Ferramentas".

Exemplo



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




Expandir
titleGET EXECUTE_OPERATION

Método GET: EXECUTE_OPERATION

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

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"EXECUTE_OPERATION", < Operação >) ==> 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_status = _ADVPL_get_property(l_form_reference,"EXECUTE_OPERATION","inform")




Expandir
titleGET INFORMED

Método GET: INFORMED

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

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"INFORMED") ==> Já 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_informed = _ADVPL_get_property(l_form_reference,"INFORMED")




Expandir
titleGET ITEM_COUNT

Método GET: ITEM_COUNT

Quantidade de linhas de um determinado multivalorado do formulário.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"ITEM_COUNT",  < Associação >) ==> Quantidade


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim
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.

Exemplo



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




Expandir
titleGET LABEL_REFERENCE

Método GET: LABEL_REFERENCE

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 >,"LABEL_REFERENCE",  < Tabela >, < Coluna >) ==> Referência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim
TabelaCHARNome da tabela da coluna do formulário da qual deseja-se recuperar a referência da descrição.Sim
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
linenumberstrue
LET l_label_reference = _ADVPL_get_property(l_form_reference,"LABEL_REFERENCE","item","cod_empresa")




Expandir
titleGET MENU_BUTTON_REFERENCE

Método GET: MENU_BUTTON_REFERENCE

Referência de um botão da barra de ferramentas do formulário.

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"MENU_BUTTON_REFERENCE", < Operação >) ==> Referência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

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

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
languageruby
themeEclipse
linenumberstrue
LET l_menubutton_reference = _ADVPL_get_property(l_form_reference,"MENU_BUTTON_REFERENCE","inform")




Expandir
titleGET MENUBAR_REFERENCE

Método GET: MENUBAR_REFERENCE

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

Sintaxe



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


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim

Retorno



Tipo

Descrição

CHAR

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

Exemplo



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




Expandir
titleGET MULTI_VALUED_BUTTON_REFERENCE

Método GET: MULTI_VALUED_BUTTON_REFERENCE 

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

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"MULTI_VALUED_BUTTON_REFERENCE",< Tabela >, < Coluna >) ==> Referência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim
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 do formulário.

Exemplo



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




Expandir
titleGET MULTI_VALUED_COLUMN_REFERENCE

Método GET: MULTI_VALUED_COLUMN_REFERENCE

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

Sintaxe



Bloco de código
_ADVPL_get_property(< l_form_reference >,"MULTI_VALUED_COLUMN_REFERENCE",< Coluna >) ==> Referência


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim
ColunaCHARNome 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
linenumberstrue
LET l_multivalued_column_reference = _ADVPL_get_property(l_form_reference,"MULTI_VALUED_COLUMN_REFERENCE","cod_item")




Expandir
titleGET MULTI_VALUED_TABLE_REFERENCE

Método GET: MULTI_VALUED_TABLE_REFERENCE

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

Sintaxe



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


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim

Retorno



Tipo

Descrição

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
languageruby
themeEclipse
linenumberstrue
LET l_multivalued_table_reference = _ADVPL_get_property(l_form_reference,"MULTI_VALUED_TABLE_REFERENCE")




Expandir
titleGET PROGRESS_BAR_REFERENCE

Método GET: PROGRESS_BAR_REFERENCE

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

Sintaxe



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


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim

Retorno



Tipo

Descrição

CHAR

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_progressbar_reference = _ADVPL_get_property(l_form_reference,"PROGRESS_BAR_REFERENCE")




Expandir
titleGET STATUS_BAR_REFERENCE

Método GET: STATUS_BAR_REFERENCE

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

Sintaxe



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


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim

Retorno



Tipo

Descrição

CHAR

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

Exemplo



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




Expandir
titleGET ZOOM_BUTTON_REFERENCE

Método GET: ZOOM_BUTTON_REFERENCE

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

Sintaxe



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


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim
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
themeEclipse
linenumberstrue
LET l_zoom_button_reference = _ADVPL_get_property(l_form_reference,"ZOOM_BUTTON_REFERENCE","item","cod_item")




Expandir
titleGET ZOOM_BUTTON_REFERENCE

Método GET: ZOOM_

BUTTON_

REFERENCE

Referência do

componente do botão de

zoom de um determinado campo do formulário.

Sintaxe



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


Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR

Referência do formulário.

Sim
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 determinado campo do formulário.

Exemplo



Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_zoom_button_reference = _ADVPL_get_property(l_form_reference,"ZOOM_BUTTON_REFERENCE","item","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

Método SET: ACTIVATE

Ativa/Desativa a janela da aplicação.

Sintaxe



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

Parâmetros



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

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

   TRUE - Ativa o formulário

   FALSE - Desativa/Fecha o formulário.

Sim

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

Exemplo



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




Expandir
titleSET CENTERENABLE_VALID_DUPLICATE_VALUES

Método SET:

CENTER

ENABLE_VALID_DUPLICATE_VALUES

Habilita/desabilita a validação de valores duplicados no(s) multivalorado(s) do formulárioCentraliza a janela da aplicação na área de trabalho do usuário.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_form_reference >,"CENTER"ENABLE_VALID_DUPLICATE_VALUES",< Habilita? >)

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).
Habilita?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,"CENTER")ENABLE_VALID_DUPLICATE_VALUES",FALSE)




Expandir
titleSET CENTERED INFORMED

Método SET:

CENTERED

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 manualmenteDefine se a tela abrirá no centro da área de trabalho.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_form_reference >,"CENTEREDINFORMED",< l_status informou?>)

Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR
Referência do formulário.Sim
l_statusJá informou?
BOOLEAN
Indicador que define se a tela será aberta no centro da área de trabalho do usuário.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,"CENTEREDINFORMED",TRUE)




Método SET: FORM_INFO 

Define se habilita o encerramento da janela com a tecla ESC.

Sintaxe

Expandir
titleSET ENABLEINIT_ESC_CLOSEPARAMETER

Método SET:

ENABLE

INIT_

ESC_CLOSE

PARAMETER

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

Define se habilita o encerramento da janela com a tecla ESC.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_form_reference >,"ENABLEINIT_ESC_CLOSEPARAMETER",< l_status >)Formulário >, [ Record ], [ Array of Record ])

Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR
Referência do formulário.Sim
l_statusFormulário 
BOOLEAN
CHAR
Nome do formulário cadastrado no programa "FRM0003 - Formulários de Parâmetros/Processamento"Indicador que define se a janela poderá ser encerrada com a tecla ESC.Sim
Exemplo
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
language
Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"ENABLE_ESC_CLOSE",FALSE)
Expandir
titleSET FORM_INFO
Bloco de código
_ADVPL_set_property(< l_form_reference >,"FORM_INFO",< informação >)

Parâmetros

NomeTipoDescriçãoObrigatório?l_form_reference
CHAR
Referência do formulário.Siminformação
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).

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.")
Expandir
titleSET FORM_MODIFICATION

Método SET: FORM_INFO 

Modificação do formulário.

Sintaxe

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

Parâmetros

NomeTipoDescriçãoObrigatório?l_form_reference
CHAR
Referência do formulário.Siminformação
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

Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"FORM_MODIFICATION","01")
Expandir
titleSET FORM_NAME

Método SET: FORM_NAME 

Modificação do formulário.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_form_name >,"FORM_INFO",< formulário >)

Parâmetros

NomeTipoDescriçãoObrigatório?l_form_name
CHAR
Referência do formulário.Simformulário
CHAR
Nome 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_name,"FORM_NAME","LOG5500")
Expandir
titleSET FORM_RELEASE

Método SET: FORM_RELEASE 

Release do formulário.

Sintaxe

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

NomeTipoDescriçãoObrigatório?l_form_reference
CHAR
Referência do formulário.Simtecla
CHAR
Tecla de atalho conforme teclas disponíveis na lista de teclas de atalhos.SimfunçãoCHARFunção que será executada ao acionar a tecla de atalho.Simdescriçã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.SimcomponenteCHARReferência do componente do qual pertence a tecla de atalho.NãostatusBOOLEANIndicador 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
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

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_form_reference >,"ITEM_COUNT", < Associação >,"MAXIMIZED", < statusQuantidade >)

Parâmetros



NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR
Referência do formulário.Sim
 Associação 
CHAR
Nome da associação do multivalorado 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
themeConfluence
linenumberstrue
CALL 

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>)

Parâmetros

10)




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
NomeTipoDescriçã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.