Pagetitle

	LGX - LWEBDIALOG
	LGX - LWEBDIALOG

Componente do tipo janela de diálogo não modal (não permite que outras janelas sejam controladas enquanto uma estiver ativa), permitindo movimentação dentro da área de trabalho do usuário e executando em modo maximizado ou normal.

Nota

icon	false

Válido apenas a partir do build HARPIA. Para build 32 bits, usando smartclient Lobo Guará, algumas propriedades podem não estar disponíveis.

Componente disponível a partir do pacote LOGIX 12.1.2503 ou Framework Fix 12.1.2411.FIX01.

Hierarquia

LCOMPONENT
- LCONTAINER
  - LFORM
    - LDIALOG
      - LWEBDIALOG

Sintaxe

Bloco de código
LET m_webdialog_reference = _ADVPL_create_component(NULL,"LWEBDIALOG")

Métodos SET

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

O componente LWEBDIALOG é incompatível com o Smartclient 32 bits do build 7.00.131227A, pois não dispõe de um componente pré-requisito do ADVPL chamado TWebEngine que permite execuções WEB nas telas do produto Logix. Já para o Smartclient do build Lobo Guará (build 7.170117A), apesar de contemplar o componente TWebEngine, foi gerado utilizando a biblioteca de componentes QT-5.9.7 que é uma versão compatível com o Chromium somente até a versão 61 ou anterior. Atualmente a versão mais recente do Chromium encontra-se na versão 134 (Informação obtida em 08/04/2025).

Atualmente apenas o Smartclient Desktop do build Harpia, ainda tem compatibilidade com versões de Chromium mais recentes, mas que deixará também de ser liberado pela Totvs a partir do build Onça Preta (Build 7.00.240223P), onde a interface dos produtos passará a ser executada apenas com navegadores Web fazendo uso de WEBApp Components e do Web-Agent.

Componente disponível a partir do pacote LOGIX 12.1.2503 ou Framework Fix 12.1.2411.FIX01.

Hierarquia

LCOMPONENT
- LCONTAINER
  - LFORM
    - LDIALOG
      - LWEBDIALOG

Sintaxe

Bloco de código
LET m_webdialog_reference = _ADVPL_create_component(NULL,"LWEBDIALOG")

Métodos GET

Métodos acessíveis através da função _ADVPL_get_property que permite recuperar e manipular os valores do componente.

Expandir

title	GET URL

Método GET: URL

Retorna o endereço atual URL carregado na janela de dialog WEB no acionamento da propriedades INIT_URL ou INIT_APP.

Sintaxe

Bloco de código
_ADVPL_get_property(< lWebDialogReference >,"URL") => cUrl

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
lWebDialogReference	`CHAR`	Referência do componente que está em foco na tela.	Sim

Retorno

Tipo	Descrição
`CHAR`	Endereço URL em execução na janela de diálogo WEB.

Exemplo

Bloco de código

linenumbers	true

LET l_url = _ADVPL_get_property(lWebDialogReference,"URL")

Expandir

title	GET CLEAR_CACHE

Método GET: CLEAR_CACHE

Retorna o valor da propriedade CLEAR_CACHE que indica se é feita a limpeza do cache antes de exibir a página WEB.

Por padrão esta propriedade é definida como TRUE na criação do componente.

Sintaxe

Bloco de código
_ADVPL_get_property(< lWebDialogReference >,"CLEAR_CACHE") => nClearCache

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
lWebDialogReference	`CHAR`	Referência do componente que está em foco na tela.	Sim

Retorno

Tipo Descrição

BOOLEAN

Indica se deve limpar ou não o cache da página web antes de exibi-la.

TRUE - Limpeza de cache ativa.

FALSE - Limpeza de cache inativa.

Exemplo

Bloco de código

linenumbers	true

LET l_enableClearCache = _ADVPL_get_property(lWebDialogReference,"CLEAR_CACHE")

Métodos SET

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

Expandir

title	SET INIT_URL

Método SET: INIT_URL

Iniciar a exibição e permitir navegação de uma página WEB para o endereço URL informado.

Sintaxe

Bloco de código
_ADVPL_set_property(< lWebDialogReference >,"INIT_URL",< l_urlAddress >)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
lWebDialogReference	`CHAR`	Referência do componente.	Sim
l_urlAddress	`CHAR`	Endereço WEB a ser apresentado para navegação.	Sim

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

     CALL _ADVPL_set_property(lWebDialogReference,"INIT_URL","https://www.totvs.com")

Expandir

title	SET INIT_APP

Método SET: INIT_APP

Iniciar a execução de uma aplicação desenvolvida com padrões Web Logix utilizando interface com componentes PO-UI.

Para correto funcionamento da aplicação, utilizando este componente e propriedade, o código do programa principal que aciona a tela com interface WEB em PO-UI é desenvolvida utilizando um fonte 4GL, que precisa ser desenvolvido com uma determinada estrutura padrão que é apresentada num código de exemplo ao final desta página onde constará um código de exemplo completo utilizando a classe LWebDialog.

Sintaxe

Bloco de código
_ADVPL_set_property(< lWebDialogReference>,"INIT_APP",< l_appwebLogix >)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
l_webdialog_reference	`CHAR`	Referência do componente.	Sim
l_appwebLogix	`CHAR`	Nome da fonte 4gl que possui a função principal que aciona a aplicação WEB Logix.	Sim

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

CALL _ADVPL_set_property(lWebDialogReference,"INIT_APP","exemploweb")

Expandir

title	SET CLEAR_CACHE

Método SET: CLEAR_CACHE

Realiza limpeza de cache da página WEB antes de exibir a URL.

Sintaxe

Bloco de código
_ADVPL_set_property(< lWebDialogReference>,"CLEAR_CACHE",< l_enableClearCache >)

Parâmetros

Nome Tipo Descrição Obrigatório?

l_webdialog_reference CHAR Referência do componente. Sim

l_enableClearCache

BOOLEAN

Indicador para forçar limpeza de cache da página WEB a ser exibida.

TRUE - Limpar o cache antes da exibição da página WEB.

FALSE - Não limpar o cache da página WEB antes de exibi-la.

Sim

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

CALL _ADVPL_set_property(lWebDialogReference,"CLEAR_CACHE", < l_enableClearCache> )

Expandir

title	SET FINISH_APP

Método SET: FINISH_APP

Encerra a janela de diálogo onde está sendo executada a aplicação WEB ou endereço URL iniciada com a propriedade INIT_APP ou INIT_URL.

Sintaxe

Bloco de código
_ADVPL_set_property(< lWebDialogReference>,"FINISH_APP")

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
lWebDialogReference	`CHAR`	Referência do componente.	Sim

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

CALL _ADVPL_set_property(lWebDialogReference,"FINISH_APP")

Expandir

title	SET ENABLE_CLOSE_BUTTON

Método SET: ENABLE_CLOSE_BUTTON

Define se habilita ou não um botão FECHAR para encerrar a janela de diálogo WEB. Por padrão este botão FECHAR é apresentado no topo da janela de diálogo.

Nota

icon	false

Disponível a partir do pacote Logix 12.1.2507 ou Framework FIX 12.1.2411.FIX02.

Sintaxe

Bloco de código
_ADVPL_set_property(< lWebDialogReference>,"ENABLE_CLOSE_BUTTON",< l_enableButton >,< l_alignButton >)

Parâmetros

Nome Tipo Descrição Obrigatório?

lWebDialogReference CHAR Referência do componente. Sim

l_enableButton

BOOLEAN

Indicador que define se a janela apresentará um botão para Fechar a janela de diálogo WEB.

TRUE - Apresentar botão FECHAR.

FALSE - Não apresentar botão FECHAR.

Sim

l_alignButton

CHAR

Alinhamento do botão FECHAR,

TOP (Padrão) - Alinhamento do botão na área superior da janela de diálogo WEB.

BOTTOM - Alinhamento do botão na área inferior da janela de diálogo WEB.

Não

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

CALL _ADVPL_set_property(lWebDialogReference,"ENABLE_CLOSE_BUTTON",FALSE)

Método SET: INIT_URL

Iniciar a exibição e permitir navegação de uma página WEB para o endereço URL informado.

Sintaxe

Expandir

title	Clique AQUI para visualizar um exemplo completo utilizando a classe LWEBDIALOG

Exemplo

Bloco de código

linenumbers	true

###---------------------------------------------------------------------------------------------------------------------------------###
### A aplicação WEB LOGIX sempre deverá ter uma função onde o prefixo é _getRelativePath() para determinar o caminho relativo da 
### pasta onde está localizada a pasta de mesmo nome da aplicação que conterá os artefatos para execução da tela WEB.
### Exemplo:
###       Aplicação: exemploweb
###       Fonte 4GL: exemploweb.4gl
###       Funções desenvolvidas neste código fonte 4GL:
###           - Function exemploweb()
###           - Function exemploweb_getRelativePath()
###--

Expandir

title	SET INIT_URL

Bloco de código
_ADVPL_set_property(< l_webdialog_reference >,"INIT_URL",< l_url_address >)

Parâmetros

NomeTipoDescriçãoObrigatório?l_webdialog_reference CHARReferência do componente.Siml_url_address

CHAR

Endereço WEB a ser apresentado para navegação.Sim

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

     CALL _ADVPL_set_property(l_webdialog_reference,"INIT_URL","https://www.totvs.com")

Expandir

title	SET INIT_APP

Método SET: INIT_APP

Iniciar a execução de uma aplicação desenvolvida com padrões Web Logix utilizando interface com componentes PO-UI.

Para correto funcionamento da aplicação, utilizando este componente e propriedade, o código do programa principal que aciona a tela com interface WEB em PO-UI é desenvolvida utilizando um fonte 4GL, que precisa ser desenvolvido com uma determinada estrutura padrão que é apresentada num código de exemplo abaixo.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_webdialog_reference >,"INIT_APP",< l_appweb_logix >)

Parâmetros

NomeTipoDescriçãoObrigatório?l_webdialog_referenceCHARReferência do componente.Siml_appweb_logix

CHAR

Nome da fonte 4gl que possui a função principal que aciona a aplicação WEB Logix.Sim

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

###---------------------------------------------------------------------------------------------------------------------------------###
### A aplicação WEB LOGIX sempre deverá ter uma função onde o prefixo é _getRelativePath() para determinar o caminho relativo da 
### pasta onde está localizada a pasta de mesmo nome da aplicação que conterá os artefatos para execução da tela WEB.
### Exemplo:
###       Aplicação: exemploweb
###       Fonte 4GL: exemploweb.4gl
###       Funções desenvolvidas neste código fonte 4GL:
###           - Function exemploweb()
###           - Function exemploweb_getRelativePath()
###---------------------------------------------------------------------------------------------------------------------------------###
DATABASE logix

DEFINE m_container_reference        VARCHAR(10)
DEFINE m_webdialog_reference        VARCHAR(10)

#------------------------------------------------------------------#
 FUNCTION exemploweb()
#------------------------------------------------------------------#
    RETURN exemploweb_runInContainer(NULL)
 END FUNCTION

#------------------------------------------------------------------#
 FUNCTION exemploweb_runInContainer(l_container_refer)
#------------------------------------------------------------------#
#OBJETIVO: função para acionamento de programa a partir de uma tela COCKPIT,
#          onde deverá passar a referencia do painel lateral do cockpit, onde
#          o formulário deverá ser renderizado, como parâmetro.
    DEFINE l_container_refer  VARCHAR(10)

    INITIALIZE m_webdialog_reference TO NULL

    IF LOG_initApp("PADRAO") = 0 THEN
        IF m_container_reference <> " " THEN
            LET m_container_reference = _ADVPL_create_component(NULL,"LSCROLLPANEL",m_container_reference)
            CALL _ADVPL_set_property(m_container_reference,"ALIGN","CENTER")
        END IF
        LET m_webdialog_reference = _ADVPL_create_component(NULL,"LWEBDIALOG",m_container_reference)

        ### Neste caso imaginemos que no meu appserver está configurado assim:
        ### ROOTPATH: c:\totvs\logix
        ### Ambiente web:
        ### -------------------------------------------------
        ### [<HOST_OR_IP>:<HTTP_OR_HTTPS_PORT>/apps]
        ### ENVIRONMENT=<Environment_name>
		### RESPONSEJOB=JOBWEB
		### DEFAULTPAGE=index.html
		### PATH=c:\totvs\logix\web\apps
		### SOURCEPATH=c:\totvs\logix\web\apps
		### CACHE-CONTROL=no-store
		### PRAGMA=no-cache
        ### 
  -----------------------------------------------------------------------------------------###
DATABASE logix

DEFINE m_container_reference        VARCHAR(10)
DEFINE m_webdialog_reference      ### a aplicação exemploweb terá seus artefatos web armazenados na pasta c:\totvs\logix\web\apps\exemplos\exemploweb\
        ### Onde a pasta "/exemplos/" é a pasta relativa localizada a partir da pasta principal indicada para o ambiente web no appserver.
        ### e a pasta "exemploweb" é a pasta com o nome da aplicação que armazena todos artefatos web para execução da tela.
        CALL _ADVPL_set_property(m_webdialog_reference,"INIT_APP","exemploweb")
    END IF
 END FUNCTION

# VARCHAR(10)

#------------------------------------------------------------------#
 FUNCTION exemploweb()
#------------------------------------------------------------------#
    RETURN exemploweb_runInContainer(NULL)
 END FUNCTION

#-------------------------------------------------------------------#
FUNCTION exemploweb_getRelativePath()
#--------------------#
 FUNCTION exemploweb_runInContainer(l_container_refer)
#------------------------------------------------------------------#
#OBJETIVO: função para acionamento de programa a partir de uma tela COCKPIT,
#          onde deverá passar a referencia do painel lateral do cockpit, onde
#          o formulário deverá ser renderizado, como parâmetro.
    DEFINE l_container_refer  VARCHAR(10)

    INITIALIZE m_webdialog_reference TO NULL

    IF LOG_initApp("PADRAO") = 0 THEN
        IF m_container_reference <> " " THEN
            LET m_container_reference = _ADVPL_create_component(NULL,"LSCROLLPANEL",m_container_reference)
            CALL _ADVPL_set_property(m_container_reference,"ALIGN","CENTER")
        END IF
        LET m_webdialog_reference = _ADVPL_create_component(NULL,"LWEBDIALOG",m_container_reference)

        ### Neste caso imaginemos que no meu appserver está configurado assim:
        ### ROOTPATH: c:\totvs\logix
        ### Ambiente web:
        ### --------------------------------------------------#
   ### Retorna o caminho do PATH relativo a pasta raiz configurada a partir da pasta indicada como ROOTPATH no Appserver
        ### [<HOST_OR_IP>:<HTTP_OR_HTTPS_PORT>/apps]
        ### ENVIRONMENT=<Environment_name>
		### RESPONSEJOB=JOBWEB
		### DEFAULTPAGE=index.html
		### PATH=c:\totvs\logix\web\apps
		### SOURCEPATH=c:\totvs\logix\web\apps
		### CACHE-CONTROL=no-store
		### PRAGMA=no-cache
        ### 
   ### onde ficam armazenados os artefatos### destaa aplicação exemploweb WEBterá (imagens, html, json, artefatos angular, etc).seus artefatos web armazenados na pasta c:\totvs\logix\web\apps\exemplos\exemploweb\
   RETURN "/exemplos/"
END FUNCTION

Expandir

title	SET MAXIMIZED

Método SET: MAXIMIZED

Define se a janela abrirá maximizada.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_dialog_reference >,"MAXIMIZED",< situação >)

Parâmetros

NomeTipoDescriçãoObrigatório?l_dialog_reference CHARReferência do componente.Simalinhamento

BOOLEAN

Indicador que define se a janela abrirá maximizada.Sim

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

CALL _ADVPL_set_property(l_dialog_reference,"MAXIMIZED",FALSE)

Expandir

title	SET ENABLE_ESC_CLOSE

Método SET: ENABLE_ESC_CLOSE

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

Sintaxe

Bloco de código
_ADVPL_set_property(< l_dialog_reference >,"ENABLE_ESC_CLOSE",< situação >)

Parâmetros

NomeTipoDescriçãoObrigatório?l_dialog_reference CHARReferência do componente.Simsituação

BOOLEAN

Indicador que define se a janela poderá ser encerrada com a tecla ESC.Sim

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

     ### Onde a pasta "/exemplos/" é a pasta relativa localizada a partir da pasta principal indicada para o ambiente web no appserver.
        ### e a pasta "exemploweb" é a pasta com o nome da aplicação que armazena todos artefatos web para execução da tela.
        CALL _ADVPL_set_property(lm_dialogwebdialog_reference,"ENABLEINIT_ESC_CLOSEAPP",FALSE)

Expandir

title	Exemplo completo

Exemplo

Bloco de código

linenumbers	true

#--"exemploweb")
    END IF
 END FUNCTION

#----------------------------------------------------------------------------#
FUNCTION LDIALOG_test()
#------------#
FUNCTION exemploweb_getRelativePath()
#------------------------------------------------------------------#
    DEFINE l_dialog_reference VARCHAR(10)

    LET l_dialog_reference = _ADVPL_create_component(NULL,"LDIALOG")
    CALL _ADVPL_set_property(l_dialog_reference,"SIZE",640,480)
    CALL _ADVPL_set_property(l_dialog_reference,"TITLE","Exemplo de componente LDIALOG")
    CALL _ADVPL_set_property(l_dialog_reference,"MAXIMIZED",FALSE)
    CALL _ADVPL_set_property(l_dialog_reference,"ENABLE_ESC_CLOSE",FALSE)
    
    CALL _ADVPL_set_property(l_dialog_reference,"ACTIVATE",TRUE)#
   ### Retorna o caminho do PATH relativo a pasta raiz configurada a partir da pasta indicada como ROOTPATH no Appserver 
   ### onde ficam armazenados os artefatos desta aplicação WEB (imagens, html, json, artefatos angular, etc).
   RETURN "/exemplos/"
END FUNCTION

Visualização

Image RemovedImage Added

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 2

Nova versão Atual

Chave

Hierarquia

Sintaxe

Métodos SET

Hierarquia

Sintaxe

Métodos GET

Método GET: URL

Sintaxe

Parâmetros

Exemplo

Método GET: CLEAR_CACHE

Sintaxe

Parâmetros

Retorno

Exemplo

Métodos SET

Método SET: INIT_URL

Sintaxe

Parâmetros

Exemplo

Método SET: INIT_APP

Sintaxe

Parâmetros

Método SET: CLEAR_CACHE

Parâmetros

Método SET: FINISH_APP

Sintaxe

Parâmetros

Exemplo

Método SET: ENABLE_CLOSE_BUTTON

Sintaxe

Parâmetros

Exemplo

Método SET: INIT_URL

Sintaxe

Parâmetros

Exemplo

Método SET: INIT_APP

Sintaxe

Parâmetros

Método SET: MAXIMIZED

Sintaxe

Parâmetros

Exemplo

Método SET: ENABLE_ESC_CLOSE

Sintaxe

Parâmetros

Exemplo

Visualização