Páginas filhas
  • 9. _ADVPL_METADATA_runFormInScrollPanel


Permite forçar a carga de um formulário CRUD (FRM1002) ou de Processamento (FRM1003) dentro de um painel com barra de rolagem quando, por exemplo, houver a necessidade do formulário ser apresentado dentro de um outro painel instanciado manualmente a partir de um fonte tipo FreeForm.

(seleção) Esta função deve ser acionada antes da abertura do formulário com a ação _ADVPL_setProperty( <form_reference>, "INIT_FORM") ou  _ADVPL_setProperty( <form_reference>, "INIT_PARAMETER").

(aviso)(aviso)(aviso) ATENÇÃO! (aviso)(aviso)(aviso)  A partir do pacote Logix 12.1.2407 do build HARPIA, para acionamento de formulários CRUD e de Processamento instanciado diretamente na aba do menu, sem a existência de outro painel previamente instanciado e indicado pelo programa, o painel com barra de rolagem será sempre criado automaticamente como base para apresentar o formulário. 

Sintaxe


CALL _ADVPL_METADATA_runFormInScrollPanel( < l_formName >, < l_flag > )


Parâmetros



Nome

Tipo

Obrigatório?

Descrição

l_formName

CHAR

Sim

Nome do formulário metadado que deseja forçar a sua exbição dentro de um painel com barras de rolagem.

l_flag

SMALLINT

Sim

Indicador para abertura de formulário em painel com barra de rolagem.

TRUE - Deve exibir o formulário dentro de um painel com barra de rolagem. A barra de rolagem vertical é apresentada apenas quando a altura do formulário ultrapassar a altura total do painel disponível para visualização em tela.

FALSE - Não exibir o formulário 

Retorno


Tipo

Descrição

SMALLINT

Apenas quando o parâmetro l_flag NÃO FOR INFORMADO, o retorno desta função indicará se o formulário indicado no parâmetro l_formName foi sinalizado para abertura forçada dentro de um painel com barra de rolagem, através de um acionamento prévio desta mesma função.

TRUE - Formulário sinalizado para ser instanciado dentro de um painel com barra de rolagem.

FALSE - Formulário sinalizado para ser instanciado dentro de um painel com barra de rolagem apenas se for aberto pelo menu sem a existência de outro painel de referência indicado pela aplicação.

(informação) Caso a função não tenha sido acionada previamente para o formulário, esta função sempre irá retornar o valor FALSE.

Exemplo


   #Exemplo para forçar abertura do formulário FIN10049 com barra de rolagem dentro de um painel de referência 
   #já instanciado pelo programa e reservado para apresentar o formulário em tela
   CALL _ADVPL_METADATA_runFormInScrollPanel("fin10049",TRUE)

   LET m_form_reference = _ADVPL_create_component(NULL,"LPARMETADATA",m_painel_reference)
   CALL _ADVPL_set_property(m_form,"INIT_PARAMETER","fin10049",mr_data_form,ma_data_form)