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

Versão 1 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
 

Exemplos 
#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