Linha Logix

Páginas filhas
  • LGX - LSTATUSBAR

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


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


TipoDescriçã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


NomeTipoDescriçãoObrigatório?
   cText CHARTexto 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


NomeTipoDescriçãoObrigatório?
 cText CHARTexto 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


NomeTipoDescriçãoObrigatório?
cText CHARTexto 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


NomeTipoDescriçãoObrigatório?
cText CHARTexto 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


NomeTipoDescriçãoObrigatório?
nVisibleBOOLEANIndicador 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


NomeTipoDescriçãoObrigatório?
nVisibleBOOLEANIndicador 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


NomeTipoDescriçãoObrigatório?
 nVisible BOOLEANIndicador 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

(aviso) 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