Pagetitle

	LGX - LMENUBUTTON
	LGX - LMENUBUTTON

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

Hierarquia

LCOMPONENT

Métodos SET

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

Expandir

title	SET 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

Nome	Tipo	Descrição	Obrigatório?
Função	CHAR	Função executada quando o usuário cancelar a operação.	Sim

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

title	SET 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

Nome	Tipo	Descrição	Obrigatório?
Mensagem	CHAR	Mensagem exibida para o usuário ao cancelar a operação. Esta mensagem será exibida em vermelho na barra de status.	Sim

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

title	SET 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

Nome	Tipo	Descrição	Obrigatório?
Função	CHAR	Função executada quando o usuário confirmar a operação.	Sim

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

title	SET 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

Nome	Tipo	Descrição	Obrigatório?
Mensagem	CHAR	Mensagem exibida para o usuário ao confirmar a operação. Esta mensagem será exibida em azul na barra de status.	Sim

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

title	SET 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

Nome	Tipo	Descrição	Obrigatório?
Botão de controle?	BOOLEAN	Indicador 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

title	SET 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

Nome	Tipo	Descrição	Obrigatório?
Função	BOOLEAN	Função que será executada ao clicar sobre o botão.	Sim

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

title	SET 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

Nome	Tipo	Descrição	Obrigatório?
Mensagem	CHAR	Mensagem exibida para o usuário ao executar a operação. Esta mensagem será exibida em um alerta.	Sim

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

title	SET 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

Nome	Tipo	Descrição	Obrigatório?
Operação	CHAR	Nome atribuído para o botão na ajuda online.BOOLEAN	Sim

Exemplo

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

Expandir

title	SET 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

Nome	Tipo	Descrição	Obrigatório?	BOOLEAN	Sim

Exemplo

Imagem

CHAR

Imagem compilada no RPO a ser atribuída para o botão.

Sim

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

code

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

Expandir

title	SET

Método SET: HELP

Sintaxe

Bloco de código
_ADVPL_set_property(< l_table_reference >,"HELP_VISIBLE",< Visível? >)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
	BOOLEAN		Sim

Exemplo

Bloco de código

Expandir

title	SET

Método SET: HELP

Sintaxe

Bloco de código
_ADVPL_set_property(< l_table_reference >,"HELP_VISIBLE",< Visível? >)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
	BOOLEAN		Sim

Exemplo

Bloco de código

Expandir

title	SET

Método SET: HELP

Sintaxe

Bloco de código
_ADVPL_set_property(< l_table_reference >,"HELP_VISIBLE",< Visível? >)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
	BOOLEAN		Sim

Exemplo

Bloco de código

Exemplo

Expandir

title	Exemplo de utilização

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 4

Nova versão 5

Chave

Hierarquia

Métodos SET

Método SET: CANCEL_EVENT

Sintaxe

Parâmetros

Método SET: CANCEL_MESSAGE

Sintaxe

Parâmetros

Exemplo

Método SET: CONFIRM_EVENT

Sintaxe

Parâmetros

Método SET: CONFIRM_MESSAGE

Sintaxe

Parâmetros

Exemplo

Método SET: CONTROL_BUTTON

Sintaxe

Parâmetros

Exemplo

Método SET: EVENT

Sintaxe

Parâmetros

Método SET: EVENT_MESSAGE

Sintaxe

Parâmetros

Exemplo

Método SET:

HELP_NAME

Sintaxe

Parâmetros

Exemplo

Método SET:

IMAGE

Sintaxe

Parâmetros

Exemplo

Exemplo

Método SET: HELP

Sintaxe

Parâmetros

Exemplo

Método SET: HELP

Sintaxe

Parâmetros

Exemplo

Método SET: HELP

Sintaxe

Parâmetros

Exemplo

Exemplo

Visualização