TOTVSTEC

Árvore de páginas

Sintaxe Mínima

@ <nRow>,<nCol> CHECKBOX <lVar>

Sintaxe Completa

@ <nRow>, <nCol> CHECKBOX [ <oCheckBox> VAR ] <lVar> 
   [ PROMPT <cCaption>]
   [ OF | WINDOW | DIALOG <oWnd> ]
   [ SIZE <nWidth>, <nHeight> ]
   [ FONT <oFont> ] 
   [ ON CLICK | ON CHANGE <cbClick> ]
   [ VALID <cbValid> ]
   [ COLOR | COLORS <nClrText> [,<nClrBack> ] ]
   [ PIXEL ] 
   [ MESSAGE <cMsg> ]
   [ WHEN <cbWhen> ]

Include

#include "totvs.ch"

Parâmetros

CláusulaTipoObrigatóriaDescrição
<nRow>NSParâmetro obrigatório, indica a linha da tela (em pixels ou coordenadas) onde o componente será exibido. Deve ser usada uma expressão numérica, constante ou variável.
<nCol>NSParâmetro obrigatório, indica a coluna da tela (em pixels ou coordenadas) onde o componente será exibido. Deve ser usada uma expressão numérica, constante ou variável.
CHECKBOX
SCláusula obrigatória, pode ser seguida diretamente da expressão caractere – constante ou variável – que deve ser exibida na tela, ou da cláusula opcional VAR
<oCheckBox>VARONQuando a cláusula VAR for informada, permite e obriga a especificar um nome de variável AdvPL imediatamente antes da cláusula, no qual o objeto do componente tCHECKBOX() será armazenado, seguido da expressão ou variável lógica cujo conteúdo será mostrado para edição na interface.
<lVar> LSIndica o nome da variável cujo conteúdo será editado na interface. deve ser do tipo "L" lógico. 
OF | WINDOW | DIALOG <oWnd>ONCláusula opcional, quando informada permite especificar o nome de uma variável AdvPL que contenha o objeto ou componente pai de interface (janela ou diálogo, painel, folder) onde o componente deve ser exibido. Caso seja omitida, o componente será criado na janela ou diálogo ativos no momento. Embora todas as cláusulas sejam suportadas (OF, DIALOG ou WINDOW), por questões de padronização de código, recomendamos o uso da cláusula OF – pois um componente de interface não necessariamente têm seu componente pai definido como uma caixa de diálogo, qualquer outro componente de agrupamento ou container pode ser utilizado – como um tPanel, tFolder, etc.
SIZE <nWidth>,<nHeight>NNCláusula opcional, quando utilizada deve ser seguida dos parâmetros numéricos <nWidth> e <nHeight>, que respectivamente indicam o comprimento e a altura do componente na interface.
FONT <oFont>ONCláusula opcional, permite informar um objeto AdvPL do tipo TFont(), para que seja possível mostrar o texto no componente usando uma fonte diferente da fonte default do ambiente. 
ON CHANGE | ON CLICK <cbClick>CNExpressão caractere, que será utilizada para gerar um bloco de código a ser executado quando o estado ou conteúdo do objeto é modificado pela ação sobre o controle visual – ou seja, quando o conteúdo editável da interface for alterado.
VALID <cbValid>CNExpressão caractere, que será utilizada para gerar um bloco de código com retorno booleano, a ser executado no momento da perda de foco do componente. A função ou expressão de validação deve retornar .T. (verdadeiro) caso o foco possa sair deste componente. Normalmente usada para validação dos dados de entrada.
COLOR | COLORS <nClrText> [ ,<nClrBack]NNCláusulas opcionais, que quando especificadas, permitem alterar a cor do texto da mensagem a ser exibida pelo componente, e opcionalmente também permite alterar a cor de fundo do texto da exibição.
PIXEL 
NCláusula opcional, quando for especificada, indica que o sistema de coordenadas usado nos parâmetros <nRow> e <nCol> são em pixels (ou pontos) a partir da coordenada superior esquerda (0,0) do componente visual pai em uso no qual o objeto será posicionado. 
MESSAGE <cMsg>CNIndica a mensagem, do tipo dica de contexto (tooltip/hint), que será apresentada ao posicionar o ponteiro do mouse sobre o objeto.
WHEN <cbWhen>CNExpressão caractere, que será utilizada para gerar um bloco de código com retorno booleano, a ser executado no momento de troca de foco de componentes da interface. A função ou expressão de validação deve retornar .T. (verdadeiro) caso o componente possa receber foco.

Classe usada pelo comando

O comando @ .. CHECKBOX é traduzido em tempo de compilação para utilizar a classe de interface visual do AdvPL TCHECKBOX() e seu método construtor NEW().

Referências

Construtor TCheckBox:New

Exemplo


Exemplo do comando @ ... CHECKBOX
#include 'totvs.ch'

User Function TCheckBox()
Local oDlg, oChkBox, lCheck := .F.

DEFINE DIALOG oDlg TITLE "Exemplo tCheckBox" FROM 100,100 TO 450,400 PIXEL

// Cria o Objeto tCheckBox usando o comando @ .. CHECKBOX
@ 10,10 CHECKBOX oChkBox VAR lCheck PROMPT "Selecione" SIZE 60,15 OF oDlg PIXEL 

ACTIVATE DIALOG oDlg CENTERED

Return

Resultado



  • Sem rótulos