Você está na página 1de 4

Pgina 1 de 4

tComboBox
Reviso: 23/02/2003

Abrangncia Verso 5.07 Classe de combobox. Verso 5.08 Verso 6.09 Verso 7.10

Hierarquia
tSrvObject -> tControl -> tComboBox

Descrio
Utilize a classe tComboBox para cria uma entrada de dados com mltipla escolha com item definido em uma lista vertical, acionada por F4 ou pelo boto esquerdo localizado na parte direita do controle. A varivel associada ao controle ter o valor de um dos itens selecionados ou no caso de uma lista indexada, o valor de seu ndice.

Propriedades
Nome aItems nAt Tipo / Descrio Array. Lista de itens, caracteres, a serem exibidos. Pode ter os seguintes formatos: a) Seqencial, exemplo: {item1,item2,...,itemN} ou b) Indexada, exemplo: {a=item1,b=item2, ..., n=itemN}. Numrico. Posio do item selecionado.

Mtodos
New Descrio Mtodo construtor da classe. New([anRow], [anCol], [abSetGet], [anItems], [anWidth], [anHeight], [aoWnd], [nPar8], [abChange], [abValid], [anClrText], [anClrBack], [alPixel], [aoFont], [cPar15], [lPar16], [abWhen], [lPar18], [aPar19], [bPar20], [cPar21], [acReadVar]) Parmetro anRow anCol Tipo / Descrio Numrico, opcional. Coordenada vertical em pixels ou caracteres. Numrico, opcional. Coordenada horizontal em pixels ou caracteres. Bloco de cdigo, opcional. Bloco de cdigo no formato {|u| if( Pcount( )>0,

Sintaxe

http://dem.microsiga.com.br/w_wEx011.apw?Cod=023139

24/8/2004

Pgina 2 de 4

abSetGet

<var>:= u, <var> ) } que o controle utiliza para atualizar a varivel <var>. <var> deve ser tipo caracter. Se a lista for seqencial, o controle atualizar <var> com o contedo do item selecionado, se a lista for indexada, <var> ser atualizada com o valor do ndice do item selecionado. Array, opcional. Lista de items, caracteres, a serem exibidos. Pode ter os seguintes formatos: a) Seqencial, exemplo: {item1,item2,...,itemN} ou b) Indexada, exemplo: {a=item1,b=item2, ..., n=itemN}. Numrico, opcional. Largura do controle em pixels. Numrico, opcional. Altura do controle em pixels. Objeto, opcional. Janela ou controle onde o controle ser criado. Reservado. Bloco de cdigo, opcional. Executado quando o controle modifica o item selecionado. Bloco de cdigo, opcional. Executado quando o contedo do controle deve ser validado, deve retornar .T. se o contedo for vlido e .F. quando o contedo for invlido. Numrico, opcional. Cor de fundo do controle. Numrico, opcional. Cor do texto do controle. Lgico, opcional. Se .T. as coordenadas informadas so em pixels, se .F. so em caracteres. Objeto, opcional. Objeto tipo tFont utilizado para definir as caractersticas da fonte utilizada para exibir o contedo do controle. Reservado. Reservado. Bloco de cdigo, opcional. Executado quando mudana de foco de entrada de

anItems

anWidth anHeight aoWnd nPar8 Parmetros abChange

abValid

anClrBack anClrText alPixel

aoFont cPar15 lPar16

http://dem.microsiga.com.br/w_wEx011.apw?Cod=023139

24/8/2004

Pgina 3 de 4

abWhen lPar18 aPar19 bPar20 cPar21

dados est sendo efetuada na janela onde o controle foi criado. O bloco deve retornar .T. se o controle deve permanecer habilitado ou .F. se no. Reservado. Reservado. Reservado. Reservado. Caractere, opcional. Nome da varivel que o controle dever manipular, dever ser a mesma varivel informada no parmetro abSetGet, e ser o retorno da funo ReadVar( ).

acReadVar

Retorno

O objeto criado.

Select Descrio Sintaxe Parmetros Retorno Muda o item selecionado no combobox. Select( [anItem] ) Parmetro anItem NIL Tipo / Descrio Numrico, opcional. Posio do item a ser selecionado.

Exemplo
#include protheus.ch User Function TesteGet() Local oDlg, oButton, oCombo, cCombo, aItems:= {item1,item2,item3} cCombo:= aItems[2] DEFINE MSDIALOG oDlg FROM 0,0 TO 300,300 PIXEL TITLE Meu Combo oCombo:= tComboBox():New(10,10,{|u|if(PCount()>0,cCombo:=u,cCombo)},; aItems,100,20,oDlg,,{||MsgStop(Mudou item)},; ,,,.T.,,,,,,,,,cCombo) // Boto para fechar a janela @ 40,10 BUTTON oButton PROMPT Fechar OF oDlg PIXEL ACTION oDlg:End() ACTIVATE MSDIALOG oDlg CENTERED MsgStop( O valor +cCombo ) Return NIL

Grupos Relacionados Principal / A Linguagem AdvPl / Classes da Interface Visual / Classes de Componentes / Classes de Componentes Visuais Veja tambm Principal / A Linguagem AdvPl / Classes da Interface Visual / Classes de Componentes / tControl Principal / A Linguagem AdvPl / Classes da Interface Visual / tSrvObject

http://dem.microsiga.com.br/w_wEx011.apw?Cod=023139

24/8/2004

Pgina 4 de 4

Topo da Pgina

http://dem.microsiga.com.br/w_wEx011.apw?Cod=023139

24/8/2004