Linha Logix

Páginas filhas
  • LGX - LCOMBOBOX

Versões comparadas

Versão antiga 1

changes.mady.by.user Ieda Ferreira Alves Flock

Gravado em

comparado com

Nova versão 2

changes.mady.by.user Ieda Ferreira Alves Flock

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Pagetitle
LGX - LCOMBOBOX
LGX - LCOMBOBOX
Componente que permite criar uma caixa de seleção no formato lista para escolha de seleção de um valor.


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:


Expandir
titleGET INDEX_SELECTED

Método GET: INDEX_SELECTED

Índice do item selecionado.

Sintaxe


Bloco de código
_ADVPL_get_property( < l_combobox_reference >, "INDEX_SELECTED" ) => INTEGER

Retorno


TipoDescrição
INTEGER

Índice do item selecionado.


Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
LET l_index_selected = _ADVPL_get_property(l_combobox_reference,"INDEX_SELECTED")


Expandir
titleGET INDEX_VALUE

Método GET: INDEX_VALUE

Valor do item do correspondente ao índice informado.

Sintaxe


Bloco de código
_ADVPL_get_property( < l_combobox_reference >, "INDEX_VALUE", < Índice > ) => INTEGER

Parâmetros


NomeTipoDescriçãoObrigatório?
   Índice INTEGER

Índice do item do qual será retornado o valor

Sim

Retorno


TipoDescrição
QUALQUER

Valor do índice selecionado.


Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
LET l_index_value = _ADVPL_get_property(l_combobox_reference,"INDEX_VALUE",2)




Métodos SET

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


Expandir
titleSET ADD_ITEM

Método SET: ADD_ITEM

Adiciona um item na lista da caixa de seleção.

Sintaxe


Bloco de código
_ADVPL_get_property( < l_combobox_reference >, "ADD_ITEM",< Valor>, < Descrição > ) =>

Parâmetros


NomeTipoDescriçãoObrigatório?
ValorQUALQUERValor definido para o item em questão.Sim
Descrição CHAR

Índice do item do qual será retornado o valor

Sim


Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_combobox_reference,"ADD_ITEM","C","Cancelado")


Expandir
titleSET CLEAR

Método SET: CLEAR 

Remove todos os itens da lista da caixa de seleção.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_checkbox_reference >,"CLEAR")


Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_combobox_reference,"CLEAR")



Expandir
titleSET VALUEREMOVE_CHECKEDITEM

Método SET:

VALUE

REMOVE_

CHECKED

ITEM

Remove um item da lista da

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

Sintaxe


Bloco de código
_ADVPL_set_property(< l_checkbox_reference >,"VALUEREMOVE_CHECKEDITEM",< valorÍndice >)

Parâmetros


NomeTipoDescriçãoObrigatório?
valor Índice QUALQUERINTEGERValor que a variável do componente receberá quando a caixa de seleção estiver assinaladaÍndice do item que será removido.Sim


Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_checkboxcombobox_reference,"VALUEREMOVE_CHECKEDITEM","S"1)



Expandir
titleSET VALUESELECT_NCHECKEDITEM

Método SET:

VALUE

SELECT_

NCHECKED

ITEM 

Seleciona um item da lista da

Valor quando a caixa de seleção NÃO estiver assinaladaatravés do índice informado.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_checkbox_reference >,"VALUESELECT_NCHECKEDITEM", < Índice>, [ Altera valor?] >)

Parâmetros


NomeTipoDescriçãoObrigatório?
ÍndiceINTEGERÍndice do item da lista que deverá ser selecionado.Sim
Altera valor?QUALQUERBOOLEANValor 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
Indicador que define se será atualizado o valor da variável ao selecionar o item.

(informação)  Se o parâmetro Atualiza valor? não foi informado, será considerado o valor padrão TRUE.

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_combobox_reference,"SELECT_ITEM",1)    



Expandir
titleSET SELECT_VALUE

Método SET: SELECT_VALUE

Seleciona um item da lista da caixa de seleção através do valor informado.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_checkbox_reference >,"SELECT_VALUE", < Índice>, [ Altera valor?] )

Parâmetros


NomeTipoDescriçãoObrigatório?
ÍndiceINTEGERÍndice do item da lista que deverá ser selecionado.Sim
Altera valor?BOOLEANIndicador que define se será atualizado o valor da variável ao selecionar o item.

(informação)  Se o parâmetro Atualiza valor? não foi informado, será considerado o valor padrão TRUE.

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_combobox_reference,"SELECT_VALUE","C")  



Exemplos

Expandir
titleExemplo de utilização
Bloco de código
languageruby
themeConfluence
linenumberstrue
#--------------------# FUNCTION LCheckBoxLComboBox()#--------------------#

     	DEFINE l_dialog_reference   VARCHAR(10)
     	DEFINE l_checkboxcombobox_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.: LCHECKBOXLCOMBOBOX") 
     	CALL _ADVPL_set_property(l_dialog_reference,"BACKGROUND_COLOR",210,210,210) 

     	LET l_checkboxcombobox_reference = _ADVPL_create_component(NULL,"LCHECKBOXLCOMBOBOX",l_dialog_reference) 

     	CALL _ADVPL_set_property(l_checkboxcombobox_reference,"POSITION",05,05) 
     	CALL _ADVPL_set_property(l_checkboxcombobox_reference,"VALUE_CHECKEDADD_ITEM","A","SAtivo") 
     	CALL _ADVPL_set_property(l_checkboxcombobox_reference,"VALUE_NCHECKEDADD_ITEM","B","NBloqueado") 
     	CALL _ADVPL_set_property(l_checkboxcombobox_reference,"ADD_ITEM","TEXTC","Permite valor nulo?Cancelado") 
     	CALL _ADVPL_set_property(l_dialog_reference,"MAXIMIZED",FALSE) 
     	CALL _ADVPL_set_property(l_dialog_reference,"ACTIVATE",TRUE) END FUNCTION