TOTVSTEC

Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 4 Próxima »

Classe: TCheckBox

Cria um objeto do tipo caixa de seleção (CheckBox).

Hierarquia

TSrvObject -> TControl -> TCheckBox


Construtores
Create

Create

Método construtor da classe.


Sintaxe

TCheckBox(): Create ( [ oWnd], [ bSetGet], [ nRow], [ nCol], [ cCaption], [ nWidth], [ nHeight], [ uParam8], [ bChange], [ oFont], [ bValid], [ nClrFore], [ nClrBack], [ uParam14], [ lPixel], [ cMsg], [ uParam17], [ bWhen] ) --> oObjeto


Parâmetros

 

NomeTipoDescriçãoObrigatórioReferência
oWndObjetoIndica a janela ou controle visual onde o objeto será criado.  
bSetGetBloco de códigoIndica o bloco de código que será executado na mudança do item selecionado. O bloco de código é responsável pela mudança do valor, da variável lógica, que indica o item selecionado.  
nRowNuméricoIndica a coordenada vertical.  
nColNuloIndica a coordenada horizontal.  
cCaptionCaracterIndica o título do objeto.  
nWidthNuméricoIndica a largura do objeto.  
nHeightNuméricoIndica a altura do objeto. É estipulada uma altura padrão para o objeto de 21pixels, somente sendo possível sua alteração através da aplicação de estilo, utilizando o método SetCss, devidamente documentado no TDN  
uParam8NuméricoCompatibilidade.  
bChangeBloco de códigoIndica o bloco de código que será executado quando o estado ou conteúdo do objeto é modificado pela ação sobre o controle visual.  
oFontObjetoIndica o objeto do tipo TFont utilizado para definir as características da fonte aplicada na exibição do conteúdo do controle visual.  
bValidBloco de códigoIndica o bloco de código de validação que será executado quando o conteúdo do objeto for modificado. Retorna verdadeiro (.T.), se o conteúdo é válido; caso contrário, falso (.F.).  
nClrForeNuméricoIndica a cor do texto da janela.  
nClrBackNuméricoIndica a cor de fundo da janela.  
uParam14LógicoCompatibilidade.  
lPixelLógicoIndica se considera as coordenadas passadas em pixels (.T.) ou caracteres (.F.).  
cMsgCaracterIndica a mensagem, do tipo dica de contexto (tooltip/hint), que será apresentada ao posicionar o ponteiro do mouse sobre o objeto.  
uParam17LógicoCompatibilidade.  
bWhenBloco de códigoIndica o bloco de código que será executado quando a mudança de foco da entrada de dados, na janela em que o controle foi criado, estiver sendo efetuada. Observação: O bloco de código retornará verdadeiro (.T.), se o controle permanecer habilitado; caso contrário, retornará falso (.F.).  

 

Retorno
oObjeto
    ()
  • Retorna o objeto criado.

Observações
 

Exemplos
lCheck := .T.oCheck := TCheckBox():Create( oDlg,{||lCheck},61,01,'CheckBox 001',;                               100,210,,,,,,,,.T.,,,)
New

New

Método construtor da classe.


Sintaxe

TCheckBox(): New ( [ nRow], [ nCol], [ cCaption], [ bSetGet], [ oDlg], [ nWidth], [ nHeight], [ uParam8], [ bLClicked], [ oFont], [ bValid], [ nClrText], [ nClrPane], [ uParam14], [ lPixel], [ cMsg], [ uParam17], [ bWhen] ) --> oObjeto


Parâmetros

 

NomeTipoDescriçãoObrigatórioReferência
nRowNuméricoIndica a coordenada vertical.  
nColNuméricoIndica a coordenada horizontal.  
cCaptionCaracterIndica o título do objeto.  
bSetGetBloco de códigoIndica o bloco de código que será executado na mudança do item selecionado. O bloco de código é responsável pela mudança do valor, da variável lógica, que indica o item selecionado.  
oDlgObjetoIndica a janela ou controle visual onde o objeto será criado.  
nWidthNuméricoIndica a largura do objeto.  
nHeightNuméricoIndica a altura do objeto. É estipulada uma altura padrão para o objeto de 21pixels, somente sendo possível sua alteração através da aplicação de estilo, utilizando o método SetCss, devidamente documentado no TDN  
uParam8NuméricoCompatibilidade.  
bLClickedBloco de códigoIndica o bloco de código que será executado quando clicar, com o botão esquerdo do mouse, sobre o objeto.  
oFontObjetoIndica o objeto do tipo TFont utilizado para definir as características da fonte aplicada na exibição do conteúdo do controle visual.  
bValidBloco de códigoIndica o bloco de código de validação que será executado quando o conteúdo do objeto for modificado. Retorna verdadeiro (.T.), se o conteúdo é válido; caso contrário, falso (.F.).  
nClrTextNuméricoIndica a cor do texto da janela.  
nClrPaneNuméricoIndica a cor de fundo da janela.  
uParam14LógicoCompatibilidade.  
lPixelLógicoIndica se considera as coordenadas passadas em pixels (.T.) ou caracteres (.F.).  
cMsgCaracterIndica a mensagem, do tipo dica de contexto (tooltip/hint), que será apresentada ao posicionar o ponteiro do mouse sobre o objeto.  
uParam17LógicoCompatibilidade.  
bWhenBloco de códigoIndica o bloco de código que será executado quando a mudança de foco da entrada de dados, na janela em que o controle foi criado, estiver sendo efetuada. Observação: O bloco de código retornará verdadeiro (.T.), se o controle permanecer habilitado; caso contrário, retornará falso (.F.).  

 

Retorno
oObjeto
    ()
  • Retorna o objeto criado.

Observações
 

Exemplos
lCheck := .T.oCheck1 := TCheckBox():New(01,01,'CheckBox 001',{||lCheck},oDlg,100,210,,,,,,,,.T.,,,)

Métodos
CtrlRefresh

CtrlRefresh

Atualiza as informações do objeto.


Sintaxe

TCheckBox(): CtrlRefresh ( ) -->


Observações
 

Exemplos
oCheck:CtrlRefresh()

Observações
 
Exemplo
#include "TOTVS.CH"
User Function TCheckBox()
	DEFINE DIALOG oDlg TITLE "Exemplo TCheckBox" FROM 180,180 TO 550,700 PIXEL
		lCheck := .T.    // Usando New    
		oCheck1 := TCheckBox():New(01,01,'CheckBox 001',{||lCheck},oDlg,100,210,,,,,,,,.T.,,,)
		oCheck2 := TCheckBox():New(11,01,'CheckBox 002',{||lCheck},oDlg,100,210,,,,,,,,.T.,,,)
		oCheck3 := TCheckBox():New(21,01,'CheckBox 003',,oDlg,100,210,,,,,,,,.T.,,,)
		oCheck4 := TCheckBox():New(31,01,'CheckBox 004',,oDlg,100,210,,,,,,,,.T.,,,)
		oCheck5 := TCheckBox():New(41,01,'CheckBox 005',,oDlg,100,210,,,,,,,,.T.,,,)
		// Usando Create
		oCheck6 := TCheckBox():Create( oDlg,{||lCheck},61,01,'CheckBox 006',100,210,,,,,,,,.T.,,,)
		oCheck7 := TCheckBox():Create( oDlg,{||lCheck},71,01,'CheckBox 007',100,210,,,,,,,,.T.,,,)
	ACTIVATE DIALOG oDlg CENTERED
Return

Preview
Exemplo da classe TCheckBox

Abrangência
Microsiga Protheus 8.11 , Microsiga Protheus 11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server

 

  • Sem rótulos