Linha Logix

Páginas filhas
  • 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:


Método GET: INDEX_SELECTED

Índice do item selecionado.

Sintaxe


_ADVPL_get_property( < l_combobox_reference >, "INDEX_SELECTED" ) => INTEGER

Retorno


TipoDescrição
INTEGER

Índice do item selecionado.


Exemplo


LET l_index_selected = _ADVPL_get_property(l_combobox_reference,"INDEX_SELECTED")


Método GET: INDEX_VALUE

Valor do item do correspondente ao índice informado.

Sintaxe


_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


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.


Método SET: ADD_ITEM

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

Sintaxe


_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


CALL _ADVPL_set_property(l_combobox_reference,"ADD_ITEM","C","Cancelado")


Método SET: CLEAR 

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

Sintaxe


_ADVPL_set_property(< l_checkbox_reference >,"CLEAR")


Exemplo


CALL _ADVPL_set_property(l_combobox_reference,"CLEAR")



Método SET: REMOVE_ITEM

Remove um item da lista da caixa de seleção.

Sintaxe


_ADVPL_set_property(< l_checkbox_reference >,"REMOVE_ITEM",< Índice >)

Parâmetros


NomeTipoDescriçãoObrigatório?
 Índice INTEGERÍndice do item que será removido.Sim


Exemplo


CALL _ADVPL_set_property(l_combobox_reference,"REMOVE_ITEM",1)



Método SET: SELECT_ITEM 

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

Sintaxe


_ADVPL_set_property(< l_checkbox_reference >,"SELECT_ITEM", < Í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


CALL _ADVPL_set_property(l_combobox_reference,"SELECT_ITEM",1)    



Método SET: SELECT_VALUE

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

Sintaxe


_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


CALL _ADVPL_set_property(l_combobox_reference,"SELECT_VALUE","C")  



Exemplos

#--------------------# FUNCTION LComboBox()#--------------------#

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

	LET l_combobox_reference = _ADVPL_create_component(NULL,"LCOMBOBOX",l_dialog_reference) 

	CALL _ADVPL_set_property(l_combobox_reference,"POSITION",05,05) 
	CALL _ADVPL_set_property(l_combobox_reference,"ADD_ITEM","A","Ativo") 
	CALL _ADVPL_set_property(l_combobox_reference,"ADD_ITEM","B","Bloqueado") 
	CALL _ADVPL_set_property(l_combobox_reference,"ADD_ITEM","C","Cancelado") 
	CALL _ADVPL_set_property(l_dialog_reference,"MAXIMIZED",FALSE) 
	CALL _ADVPL_set_property(l_dialog_reference,"ACTIVATE",TRUE) END FUNCTION