Páginas filhas
  • LGX - LMENUBUTTON

Versões comparadas

Chave

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

Pagetitle
LGX - LMENUBUTTON
LGX - LMENUBUTTON
Componente visual para criação dos botões de operações das aplicações.


Hierarquia




Métodos SET


utilizando a função _ADVPL_set_property que permite alterar e manipular os valores do componente.


Expandir
titleSET CANCEL_EVENT

Método SET: CANCEL_EVENT

Evento executado ao cancelar a operação.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_menubutton_reference >,"CANCEL_EVENT",< Função >)

Parâmetros



NomeTipoDescriçãoObrigatório?
FunçãoCHARFunção executada quando o usuário cancelar a operação.Sim

(informação) Importante: este método é valido apenas para botões que habilitam confirmação, método TYPE igual a CONFIRM. Esta função espera retorno verdadeiro ou falso, caso o evento retornar falso, a operação não será cancelada.




Expandir
titleSET CANCEL_MESSAGE

Método SET: CANCEL_MESSAGE

Mensagem exibida para o usuário ao cancelar a operação.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_menubutton_reference>,"CANCEL_MESSAGE",< Mensagem >)

Parâmetros



NomeTipoDescriçãoObrigatório?
MensagemCHARMensagem exibida para o usuário ao cancelar a operação.
Esta mensagem será exibida em vermelho na barra de status.
Sim

(informação) Importante: este método é valido apenas para botões que habilitam confirmação, método TYPE igual a CONFIRM.

Exemplo



Bloco de código
CALL _ADVPL_set_property(l_menubutton_reference,"CANCEL_MESSAGE","Atualização cancelada.")




Expandir
titleSET CONFIRM_EVENT

Método SET: CONFIRM_EVENT

Evento executado ao confirmar a operação.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_menubutton_reference >,"CONFIRM_EVENT",< Função >)

Parâmetros



NomeTipoDescriçãoObrigatório?
FunçãoCHARFunção executada quando o usuário confirmar a operação.Sim

(informação) Importante: este método é valido apenas para botões que habilitam confirmação, método TYPE igual a CONFIRM. Esta função espera retorno verdadeiro ou falso, caso o evento retornar falso, a operação não será confirmada.



Expandir
titleSET CONFIRM_MESSAGE

Método SET: CONFIRM_MESSAGE

Mensagem exibida para o usuário ao confirmar a operação.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_menubutton_reference >,"CONFIRM_MESSAGE",< Mensagem >)

Parâmetros



NomeTipoDescriçãoObrigatório?
MensagemCHARMensagem exibida para o usuário ao confirmar a operação.
Esta mensagem será exibida em azul na barra de status.
Sim

(informação) Importante: este método é valido apenas para botões que habilitam confirmação, método TYPE igual a CONFIRM.

Exemplo



Bloco de código
CALL _ADVPL_set_property(l_menubutton_reference,"CONFIRM_MESSAGE","Atualização executada com sucesso.")


Expandir
titleSET CONTROL_BUTTON

Método SET: CONTROL_BUTTON


Sintaxe



Bloco de código
_ADVPL_set_property(< l_menubutton_reference >,"CONTROL_BUTTON",< Botão de controle? >)

Parâmetros



NomeTipoDescriçãoObrigatório?
Botão de controle?BOOLEANIndicador que define se o botão será um botão de controle, ou seja, não será manipulado pelas operações do tipo CONFIRM.Sim


Exemplo



Bloco de código
CALL _ADVPL_set_property(l_menubutton_reference,"CONTROL_BUTTON",FALSE)


Expandir
titleSET EVENT

Método SET: EVENT 

Evento principal, executado ao clicar sobre o botão.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_menubutton_reference >," EVENT ",< Função >)

Parâmetros



NomeTipoDescriçãoObrigatório?
FunçãoBOOLEANFunção que será executada ao clicar sobre o botão.Sim

(informação) Importante: para os botões de menu que possuem habilitação de confirmação, método TYPE igual a CONFIRM, este evento espera retorno verdadeiro ou falso. Caso o evento retornar falso, a operação será cancelada.




Expandir
titleSET EVENT_MESSAGE

Método SET: EVENT_MESSAGE

Mensagem exibida para o usuário ao executar a operação.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_menubutton_reference >,"EVENT_MESSAGE",< Mensagem >)

Parâmetros



NomeTipoDescriçãoObrigatório?
MensagemCHARMensagem exibida para o usuário ao executar a operação.
Esta mensagem será exibida em um alerta.
Sim

(informação) Importante: Este método é válido apenas para a operação de excluir (delete) e processar (process).

Exemplo



Bloco de código
CALL _ADVPL_set_property(l_menubutton_reference,"EVENT_MESSAGE","Deseja excluir o registro atual?")


Expandir
titleSET HELP_NAME

Método SET:

HELP 

HELP_NAME

Nome atribuído para o botão na ajuda online.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_tablemenubutton_reference >reference>,"HELP_VISIBLENAME",< Visível?Operação >)

Parâmetros



NomeTipoDescriçãoObrigatório?
OperaçãoCHARNome atribuído para o botão na ajuda online.BOOLEANSim


Exemplo



Bloco de código
CALL _ADVPL_set_property(l_menubutton_reference,"HELP_NAME","atualizar")


Expandir
titleSET IMAGE

Método SET:

HELP 

IMAGE

Imagem atribuída para o botão.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_tablemenubutton_reference >reference>,"HELP_VISIBLEIMAGE",< Visível?Imagem >)

Parâmetros



Sim
NomeTipoDescriçãoObrigatório?BOOLEAN
ImagemCHARImagem compilada no RPO a ser atribuída para o botão.Sim

(informação) Importante: é necessário a criação de uma imagem exatamente igual em preto-e-branco e com o nome do arquivo iniciando com a letra D, para ser visualizada quando o botão estiver desabilitado.

Exemplo



Bloco de código
CALL _ADVPL_set_property(l_menubutton_reference,"IMAGE","LANCAMENTOS_EX")


Expandir
titleSET OPERATION

Método SET:

HELP 

OPERATION

Nome da operação do botão.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_tablemenubutton_reference >reference>,"HELP_VISIBLEOPERATION",< Visível?Operação >)

Parâmetros



NomeTipoDescriçãoObrigatório?
OperaçãoCHARNome da operação do botão.BOOLEANSim

(informação) Importante: esta operação é o texto que será retornado pelo método CURRENT_OPERATION do componente LMenuBar.

Exemplo



Bloco de código
CALL _ADVPL_set_property(l_menubutton_reference,"OPERATION","ATUALIZAR")


Exemplo

Expandir
titleSET TYPE

Método SET:

HELP 

TYPE

Tipo do botão.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_tablemenubutton_reference >reference>,"HELP_VISIBLETYPE",< Visível?Tipo >)

Parâmetros



NomeTipoDescriçãoObrigatório?
BOOLEANTipoSim

Exemplo

Bloco de código
Expandir
titleSET
CHARTipo do botão de operação, sendo:


  • CONFIRM: indica que o botão habilita confirmação, ou seja, aguarda a interação do usuário para confirmar ou cancelar a operação.
  • NO_CONFIRM: indica que o botão não habilita confirmação, ou seja, não necessita da interação do usuário para confirmar ou cancelar a operação. Ao clicar sobre este botão, o evento é executado e a operação imediatamente finalizada.
Sim

(informação) Importante: caso seja definido que o botão é do tipo CONFIRM, é necessário efetuar a chamada dos métodos CONFIRM_EVENT e CANCEL_EVENT.

Exemplo



Bloco de código
CALL 

Método SET: HELP 

Sintaxe

Bloco de código
_ADVPL_set_property(< l_tablemenubutton_reference >,"TYPE","HELPNO_VISIBLE",< Visível? >)

Parâmetros

NomeTipoDescriçãoObrigatório?
BOOLEANSim
Bloco de código
CONFIRM")



Exemplo



Expandir
titleExemplo de utilização
Bloco de código
languageruby
themeConfluence
linenumberstrue

Visualização

#----------------------#
 FUNCTION LMenuButton()
#----------------------#
     DEFINE l_dialog_reference     VARCHAR(10)
     DEFINE l_menubar_reference    VARCHAR(10)
     DEFINE l_menubutton_reference VARCHAR(10)
     DEFINE l_label_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","Ex.: LMENUBAR")
     CALL _ADVPL_set_property(l_dialog_reference,"BACKGROUND_COLOR",210,210,210)

     LET l_menubar_reference = _ADVPL_create_component(NULL,"LMENUBAR",l_dialog_reference)
     CALL _ADVPL_set_property(l_menubar_reference,"HELP_VISIBLE",FALSE)

     LET l_menubutton_reference = _ADVPL_create_component(NULL,"LMENUBUTTON",l_menubar_reference)
     CALL _ADVPL_set_property(l_menubutton_reference,"IMAGE","QUIT_EX")
     CALL _ADVPL_set_property(l_menubutton_reference,"TYPE","NO_CONFIRM")
     CALL _ADVPL_set_property(l_menubutton_reference,"EVENT","LMenuButton_fecha_tela")

     LET l_label_reference = _ADVPL_create_component(NULL,"LCLABEL",l_dialog_reference)
     CALL _ADVPL_set_property(l_label_reference,"ALIGN","CENTER")
     CALL _ADVPL_set_property(l_label_reference,"TEXT","Exemplo de uma aplicação com menu.")
     CALL _ADVPL_set_property(l_dialog_reference,"MAXIMIZED",FALSE)
     CALL _ADVPL_set_property(l_dialog_reference,"ACTIVATE",TRUE) END FUNCTION


Visualização


Image AddedImage Removed