Linha Logix

Páginas filhas
  • LGX - LCHECKBOX

Componente do tipo janela de diálogo não modal (não permite que outras janelas sejam controladas enquanto uma estiver ativa), permitindo movimentação dentro da área de trabalho do usuário e executando em modo maximizado ou normal.


Hierarquia


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 

Texto descritivo criado à direita do componente.

Sintaxe


_ADVPL_get_property( < l_checkbox_reference >, "TEXT" ) => CHAR

Retorno


TipoDescrição
CHAR

Texto que descreve o componente, criado à direita do componente.


Exemplo


LET l_text = _ADVPL_get_property(l_checkbox_reference,"TEXT")


Método GET: VALUE_CHECKED

Valor quando a caixa de seleção estiver assinalada.

Sintaxe


_ADVPL_get_property( < l_checkbox_reference >, "VALUE_CHECKED" ) => Valor

Retorno


TipoDescrição
QUALQUER

Valor que a variável do componente receberá quando a caixa de seleção estiver assinalada.


Exemplo


LET l_value_checked = _ADVPL_get_property(l_checkbox_reference,"VALUE_CHECKED")


Método GET: VALUE_NCHECKED 

Valor quando a caixa de seleção NÃO estiver assinalada.

Sintaxe


_ADVPL_get_property( < l_checkbox_reference >, "VALUE_NCHECKED" ) => Valor

Retorno


TipoDescrição
QUALQUER

Valor que a variável do componente receberá quando a caixa de seleção NÃO estiver assinalada.


Exemplo


LET l_value_nchecked = _ADVPL_get_property(l_checkbox_reference,"VALUE_NCHECKED")



Métodos SET

Métodos acessíveis utilizando a função _ADVPL_set_property que permite alterar e manipular os valores do componente.


Método SET: TEXT 

Texto descritivo criado à direita do componente.

Sintaxe


_ADVPL_set_property(< l_checkbox_reference >,"TEXT",< Texto >)

Parâmetros


NomeTipoDescriçãoObrigatório?
  Texto CHARTexto que descreve o componente, criado à direita do componente.Sim

Exemplo


CALL _ADVPL_set_property(l_checkbox_reference,"TEXT","Permite valor nulo?")



Método SET: VALUE_CHECKED

Valor quando a caixa de seleção estiver assinalada.

Sintaxe


_ADVPL_set_property(< l_checkbox_reference >,"VALUE_CHECKED",< valor >)

Parâmetros


NomeTipoDescriçãoObrigatório?
valorQUALQUERValor que a variável do componente receberá quando a caixa de seleção estiver assinalada.Sim


Exemplo


CALL _ADVPL_set_property(l_checkbox_reference,"VALUE_CHECKED","S")



Método SET: VALUE_NCHECKED

Valor quando a caixa de seleção NÃO estiver assinalada.

Sintaxe


_ADVPL_set_property(< l_checkbox_reference >,"VALUE_NCHECKED",< valor >)

Parâmetros


NomeTipoDescriçãoObrigatório?
valorQUALQUERValor que a variável do componente receberá quando a caixa de seleção NÃO estiver assinalada.Sim

(informação)  No Logix, por padrão, quando criado um componente deste tipo, a descrição em tela deve ser criado à direita do componente através do método TEXT.

Exemplo


#--------------------# FUNCTION LCheckBox()#--------------------#
     DEFINE l_dialog_reference   VARCHAR(10)
     DEFINE l_checkbox_reference VARCHAR(10)

     LET l_dialog_reference = _ADVPL_create_component(NULL,"LDIALOG")
     CALL _ADVPL_set_property(l_dialog_reference,"SIZE",160,120)
     CALL _ADVPL_set_property(l_dialog_reference,"TITLE","Ex.: LCHECKBOX")
     CALL _ADVPL_set_property(l_dialog_reference,"BACKGROUND_COLOR",210,210,210)

     LET l_checkbox_reference = _ADVPL_create_component(NULL,"LCHECKBOX",l_dialog_reference)

     CALL _ADVPL_set_property(l_checkbox_reference,"POSITION",05,05)
     CALL _ADVPL_set_property(l_checkbox_reference,"VALUE_CHECKED","S")
     CALL _ADVPL_set_property(l_checkbox_reference,"VALUE_NCHECKED","N")
     CALL _ADVPL_set_property(l_checkbox_reference,"TEXT","Permite valor nulo?")
     CALL _ADVPL_set_property(l_dialog_reference,"MAXIMIZED",FALSE)
     CALL _ADVPL_set_property(l_dialog_reference,"ACTIVATE",TRUE) END FUNCTION