Page tree

Classe:LStatusBar.prw
Herança:LStatusBarLComponent
Sintaxe:
LET l_statusbar_reference = _ADVPL_create_component( NULL, "LSTATUSBAR", < cReference > )

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.

Métodos SET

 

TEXT, < cText >
Exibe uma mensagem na barra de status.

 INFO_TEXT, < cText >
Exibe uma mensagem informativa na barra de status.
 WARNING_TEXT, < cText >
Exibe uma mensagem de aviso na barra de status.
 ERROR_TEXT, < cText >
Exibe uma mensagem de erro na barra de status.
 CLEAR_TEXT
Limpa qualquer mensagem ativa na barra de status.
 VISIBLE_ABOUT, < nVisible >
Define a visibilidade do botão Sobre na barra de status.
 VISIBLE_HOTKEY, < nVisible >
Define a visibilidade do botão de teclas de atalhos na barra de status.
 VISIBLE_RESIZE, < nVisible >
Define a visibilidade do botão de maximização da janela na barra de status.

Para visualizar os métodos herdados da classe pai, visite a página do componente LComponent.


TEXT

Exibe uma mensagem na barra de status.

Parâmetros:
cText < obrigatório >Texto com a mensagem que será exibida
Sintaxe:
CALL _ADVPL_set_property( < cReference >, "TEXT", < cText > )

INFO_TEXT

Exibe uma mensagem informativa na barra de status.

Parâmetros:
cText < obrigatório >Texto com a mensagem que será exibida
Sintaxe:
CALL _ADVPL_set_property( < cReference >, "INFO_TEXT", < cText > )

WARNING_TEXT

Exibe uma mensagem de aviso na barra de status.

Parâmetros:
cText < obrigatório >Texto com a mensagem que será exibida
Sintaxe:
CALL _ADVPL_set_property( < cReference >, "WARNING_TEXT", < cText > )

ERROR_TEXT

Exibe uma mensagem de erro na barra de status.

Parâmetros:
cText < obrigatório >Texto com a mensagem que será exibida
Sintaxe:
CALL _ADVPL_set_property( < cReference >, "ERROR_TEXT", < cText > )

CLEAR_TEXT

Limpa qualquer mensagem ativa na barra de status.

Parâmetros:
Nenhum
Sintaxe:
CALL _ADVPL_set_property( < cReference >, "CLEAR_TEXT" )

VISIBLE_ABOUT

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

Parâmetros:
nVisible < obrigatório >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 
Sintaxe:
CALL _ADVPL_set_property( < cReference >, "VISIBLE_ABOUT", < nVisible > )

VISIBLE_HOTKEY

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

Parâmetros:
nVisible < obrigatório >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 
Sintaxe:
CALL _ADVPL_set_property( < cReference >, "VISIBLE_HOTKEY", < nVisible > )

VISIBLE_RESIZE

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

Parâmetros:
nVisible < obrigatório >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
Sintaxe:
CALL _ADVPL_set_property( < cReference >, "VISIBLE_RESIZE", < nVisible > )

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

Métodos GET

[ cText ]

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

Para visualizar os métodos herdados da classe pai, visite a página do componente LComponent.


TEXT

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

Retorno:
cTextTexto em exibição na barra de status
Sintaxe:
LET l_text = _ADVPL_get_property( < cReference >, "TEXT" )

Exemplo de Utilização

#--------------------#
 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