Cria uma barra de status na janela atual.

Possui botões para visualizar detalhes sobre o programa em execução, teclas de atalho e maximar a janela atual.

Por padrão, este componente deve ser criado diretamente na referência da janela.

Hierarquia

LCOMPONENT

Sintaxe

_ADVPL_create_component( NULL, "LSTATUSBAR", < cReference > )

Métodos GET

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

Método GET: TEXT

Retorna o texto em exibição na barra de status.

Sintaxe

_ADVPL_get_property( < cReference >, "TEXT" )

Retorno

Tipo	Descrição
`CHAR`	Texto em exibição na barra de status.

Exemplo

  LET l_text = _ADVPL_get_property( < cReference >, "TEXT" )

Métodos SET

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

Método SET: TEXT

Exibe uma mensagem na barra de status.

Sintaxe

_ADVPL_set_property(< cReference >,"TEXT",< cText >)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
cText	CHAR	Texto com a mensagem que será exibida.	Sim

Exemplo

CALL _ADVPL_set_property( < cReference >, "TEXT", < cText > )

Método SET: INFO_TEXT

Exibe uma mensagem informativa na barra de status.

Sintaxe

_ADVPL_set_property( < cReference >, "INFO_TEXT", < cText > )

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
cText	`CHAR`	Texto com a mensagem que será exibida.	Sim

Exemplo

CALL _ADVPL_set_property( < cReference >, "INFO_TEXT", < cText > )

Método SET: WARNING_TEXT

Exibe uma mensagem de aviso na barra de status.

Sintaxe

_ADVPL_set_property( <cReference>, "WARNING_TEXT", < cText >)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
cText	`CHAR`	Texto com a mensagem que será exibida.	Sim

Exemplo

     CALL _ADVPL_set_property( < cReference >, "WARNING_TEXT", < cText > )

Método SET: ERROR_TEXT

Exibe uma mensagem de erro na barra de status.

Sintaxe

_ADVPL_set_property( < cReference >, "ERROR_TEXT", < cText > )

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
cText	`CHAR`	Texto com a mensagem que será exibida.	Sim

Exemplo

CALL _ADVPL_set_property( < cReference >, "ERROR_TEXT", < cText > )

Método SET: CLEAR_TEXT

Limpa qualquer mensagem ativa na barra de status.

Sintaxe

_ADVPL_set_property( <cReference>, "CLEAR_TEXT")

Exemplo

     CALL _ADVPL_set_property( < cReference >, "CLEAR_TEXT" )

Método SET: VISIBLE_ABOUT

Define a visibilidade do botão Sobre na barra de status.

Sintaxe

_ADVPL_set_property( <cReference>, "VISIBLE_ABOUT", <nVisible> )

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
nVisible	`BOOLEAN`	Indicador que define a visibilidade do botão Sobre, sendo: TRUE: o botão Sobre ficará visível na barra de status FALSE: o botão Sobre não ficará visível na barra de status	Sim

Exemplo

     CALL _ADVPL_set_property( <cReference>, "VISIBLE_ABOUT", <nVisible> )

Método SET: VISIBLE_HOTKEY

Define a visibilidade do botão de tecla de atalho na barra de status.

Sintaxe

_ADVPL_set_property( <cReference>, "VISIBLE_HOTKEY", <nVisible> )

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
nVisible	`BOOLEAN`	Indicador que define a visibilidade do botão de teclas de atalho, sendo: TRUE: o botão de teclas de atalho ficará visível na barra de status FALSE: o botão de teclas de atalho não ficará visível na barra de status	Sim

Exemplo

     CALL _ADVPL_set_property( <cReference>, "VISIBLE_HOTKEY", <nVisible> )

Método SET: VISIBLE_RESIZE

Define a visibilidade do botão de maximização da janela na barra de status.

Sintaxe

_ADVPL_set_property( <cReference>, "VISIBLE_RESIZE", < nVisible > )

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
nVisible	`BOOLEAN`	Indicador que define a visibilidade do botão de maximização da janela, sendo: TRUE: o botão de maximização da janela ficará visível na barra de status FALSE: o botão de maximização da janela não ficará visível na barra de status	Sim

Para utilizar o botão de maximização corretamente, é necessário definir o método FORM_NAME para a janela.

Exemplo

     CALL _ADVPL_set_property( <cReference>,"VISIBLE_RESIZE", < nVisible > )

Exemplo

#--------------------#
 FUNCTION statusbar()
#--------------------#
     DEFINE l_dialog_reference,
            l_statusbar_reference VARCHAR(10)

     LET l_dialog_reference = _ADVPL_create_component(NULL,"LDIALOG")
     CALL _ADVPL_set_property(l_dialog_reference,"FORM_INFO","Exemplo de utilização do componente LSTATUSBAR.")
     CALL _ADVPL_set_property(l_dialog_reference,"FORM_NAME","dlg_statusbar")
     CALL _ADVPL_set_property(l_dialog_reference,"SIZE",400,400)
     CALL _ADVPL_set_property(l_dialog_reference,"TITLE","Exemplo de Utilização: LSTATUSBAR")

     LET l_statusbar_reference = _ADVPL_create_component(NULL,"LSTATUSBAR",l_dialog_reference)
     CALL _ADVPL_set_property(l_statusbar_reference,"INFO_TEXT","Exemplo de mensagem informativa.")
     CALL _ADVPL_set_property(l_statusbar_reference,"VISIBLE_HOTKEY",FALSE)

     CALL _ADVPL_set_property(l_dialog_reference,"ACTIVATE",TRUE)
 END FUNCTION

Visualização

Linha Logix > LGX - LSTATUSBAR > statusbar.jpg