Caixa de checagem

Nome	Caixa de checagem
Tecla de atalho	Nenhuma
Ícone
Objeto gráfico	Sim

Esta página apresenta descrição e propriedades do item CheckBox.

CheckBox

ico Este objeto pode ser utilizado para proporcionar ao usuário uma escolha entre dois valores tais como:

SIM / NÃO

ON / OFF

Habilita / Desabilita

Propriedades de identificação do objeto
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)
Argumentos	Neste campo pode-se inserir uma string que será o valor da propriedade Argument do item. A string fornecida é uma forma geral de passagem de parâmetros para os scripts associados ao objeto durante sua execução.	(Nenhum)

Propriedades Comuns
Propriedade	Descrição	Default
Descrição	Pode-se acrescentar uma breve descrição sobre o objeto. Este campo é apenas documental não sendo utilizado no projeto. Este campo não é obrigatório.	(Nenhuma)
Título	Neste campo é possível definir um título para este objeto.	Depende
Dica	Texto a ser apresentado quando o mouse é posicionado sobre o objeto. Este campo não é obrigatório.	(Nenhuma)
Topo	Define a distância, em pixels, entre a borda superior do objeto e a borda superior da tela.	Depende
Esquerda	Define a distância, em pixels, entre a borda esquerda do objeto e a borda esquerda da tela.	Depende
Largura	Largura, em pixels, do objeto.	Depende
Altura	Altura, em pixels, do objeto.	Depende
Habilitado	Define se o objeto pode responder a interação do usuário.	Sim
Grupo com permissão de execução	Neste campo é possível selecionar qual grupo de usuários terá permissão para executar a imagem na tela da aplicação.	Todos os grupos
Visível	Define se o objeto será ou não exibido na tela.	Sim
Grupo com permissão de visualização	Neste campo é possível selecionar qual grupo de usuários terá permissão para executar imagem na tela da aplicação.	Todos os grupos

obs

As propriedades Topo, Esquerda, Largura, Altura e Título tem seus valores default definidos no momento da criação do objeto. Então, esses valores podem variar para os diferentes tipos de objeto.

Propriedades Específicas
Propriedade	Descrição	Default
Alinhamento	Define o alinhamento horizontal do texto dentro do objeto. Opções: Esquerda Direita	Direita
Transparente	Define a transparência da imagem para a cor determinada no pixel localizado no canto inferior esquerdo da figura. Se o valor do atributo “Transparente” for definido como “sim”, em toda a imagem a cor em questão não será apresentada.	Não
Modo de edição	Define qual o modo de edição do objeto Edit. Opções: Automático - Neste modo o objeto CheckBox escreve no Tag associado assim que o mesmo perder o foco ou o usuário apertar o botão “Enter”. Via script - A ação de edição do objeto CheckBox sobre o Tag associado só terá efeito a partir de um script que solicite a edição. Enquanto o script não for chamado, o objeto estará em modo Pendente, ou seja, esperando uma chamada de script para efetuar a edição. Abre os novos campos: Pendente: Cor de fundo e Pendente: Cor da fonte.	Automático
Cor de fundo	Define a cor de fundo do objeto.	RGB(255,255,255)
Pendente: Cor de fundo	Define a cor de fundo do objeto enquanto a escrita no Tag não for ativada.	FFFF00h
Pendente: Cor de fonte	Define a cor da fonte do objeto enquanto a escrita no Tag não for ativada.	000000h
Propriedades da Fonte	Abre tela para definições das propriedades da fonte.	Arial,10,Preto

obs

Transparente

Este atributo está disponível para o HIscada Pro a partir da versão 1.4.00.

Propriedades da Fonte

Este atributo está disponível para o HIscada Pro a partir da versão 1.3.00.

Tags
Propriedade	Descrição	Default
Nome Tag	Nome do Tag associado ao objeto.	(Nenhum)
Índice	Offset para o valor do Tag associado caso ele seja um vetor.	1

Eventos
Propriedade	Descrição	Default
On Click	Ação a ser executada após o evento de um clique simples sobre o objeto. Necessita do nome do script a ser executado. Este campo não é obrigatório.	(Nenhum)

API Lua

A lista das propriedades e atributos deste e outros componentes estão documentadas em Scripts e Acesso a atributos e funções de Componentes de Tela. A seguir apresentamos as tabelas com as propriedades e atributos de gerenciamento que podem ser utilizados via scripts, para o objeto descrito nessa página:

Atributos Comuns

São apresentados neste item os atributos que são comuns à grande maioria dos componentes de tela.

Atributos Comuns
Nome da Propriedade	Descrição
Visible	Torna o componente visível ou não.
Enabled	Habilita ou não a interação com o componente.
Top	Distância em pixels do topo do componente ao topo da tela em que está contido.
Left	Distância em pixels da lateral esquerda do componente à lateral esquerda da tela em que está contido.
Width	Largura em pixels do componente.
Height	Altura em pixels do componente.
Arguments	Texto preenchido no IDE na propriedade Argumentos.

CheckBox

Checkbox
Propriedades Específicas	Descrição
Checked	Booleano (true,false) que indica se o campo está marcado ou não.
UpdatePending	Quando a propriedade “Mode de Edição” estiver configurada para “via script”, a propriedade !UpdatePending (booleano) indica se o valor do campo foi alterado significando que a atualização no respectivo Tag está pendente.
SaveEdit	Quando a propriedade “Mode de Edição” estiver configurada para “via script”, atribuir 1 grava os dados do Edit no Tag somente se houver alteração, atribuir 2 sempre grava os dados do Edit no Tag associado.
CancelEdit	Quando a propriedade “Mode de Edição” estiver configurada para “via script”, atribuir 1 cancela a edição somente se houver alteração, atribuir 2 sempre cancela a edição.

Ver também