Partilhar via


Controle de CheckBox

Este controle CheckBox_ é uma caixa de seleção de dois estados. Para associar um inteiro ou uma propriedade de cadeia de caracteres a esse controle, insira o nome da propriedade na coluna Property da tabela Control. O estado selecionado da caixa define a propriedade como o valor especificado na coluna Value da tabela CheckBox ou para o valor inicial da propriedade especificada na tabela Property. Se a propriedade não tiver nenhum valor inicial, o estado verificado a definirá como 1. O estado não selecionado define a propriedade como nula.

Os controles CheckBox só podem ser usados para publicar controles AddLocal ControlEvent, AddSource ControlEvent, Remove ControlEvent, DoAction ControlEvent ou SetProperty ControlEvent.

Atributos de controle

É possível usar os atributos a seguir com esse controle. Para alterar o valor de um atributo usando um evento, assine o controle em um ControlEvent na tabela EventMapping e liste o identificador do atributo na coluna Attribute. Insira o identificador do ControlEvent na coluna Event.

Identificador de atributo Bit hexadecimal Descrição
IndirectPropertyName Esse é o nome de uma propriedade indireta associada ao controle. Se o bit do atributo Indirect estiver definido, o controle vai exibir ou alterar o valor da propriedade que tem esse nome. Se o bit do atributo Indirect estiver definido, esse nome também será o valor da propriedade listada na coluna Property da tabela Control.
Posição Posição do controle na caixa de diálogo. Insira a largura, a altura e as coordenadas do canto esquerdo do controle nas colunas Width, Height, X e Y da tabela Control. Use Unidades do instalador para definir o comprimento e a distância.
PropertyName Esse é o nome da propriedade associada a esse controle. Se o bit de atributo indireto não estiver definido, o controle exibirá ou alterará o valor da propriedade que tem esse nome. Esse atributo é especificado na coluna Property da tabela Control.
PropertyValue Valor atual da propriedade exibida ou alterada por esse controle. Se o bit do atributo Indirect não for definido, esse será o valor de PropertyName. Se o bit do atributo Indirect estiver definido, esse será o valor de IndirectPropertyName. Se o atributo for alterado, o controle refletirá o novo valor.
Texto Esse atributo de controle pode especificar o texto exibido pelo controle, uma imagem armazenada na tabela Binary ou um conjunto de imagens em tempo de execução. Para especificar o texto, insira a cadeia de caracteres de texto na coluna Text da tabela Control. Para definir a fonte e seu estilo em uma cadeia de texto, acrescente à cadeia de caracteres exibidos o prefixo {\style} ou {&style}. Sendo que Style é um identificador listado na coluna TextStyle da tabela TextStyle. Caso nenhum deles esteja presente, mas a propriedade DefaultUIFont seja definida como um estilo de texto válido, essa fonte será usada.
Para especificar um ícone ou uma imagem de bitmap armazenada na tabela Binary, insira a chave primária do registro da imagem na coluna Name da tabela Binary na coluna Text do registro da tabela Control para o controle.
Visível 0x00000000 0x00000001
Controle oculto. Controle visível.
Inclua esse bit na palavra de bit da coluna Attributes na tabela Control para tornar o controle visível ou oculto após a criação.
Você também pode ocultar ou mostrar um controle usando a tabela ControlCondition.
Enabled 0x00000000 0x00000002
Controle em um estado desabilitado. Controle em um estado habilitado.
Inclua esse bit na palavra de bit na coluna Attributes da tabela Control para habilitar o controle na criação.
Você também pode habilitar ou desabilitar um controle usando a tabela ControlCondition.
Sunken 0x00000000 0x00000004
Exibe o estilo visual padrão. Exibe o controle com uma aparência 3D em baixo-relevo.
Inclua esses bits na palavra de bit da coluna Attributes da tabela Control.
Indireto. 0x00000000 0x00000008
O controle exibe ou altera o valor da propriedade na coluna Property da tabela Control. O controle exibe ou altera o valor da propriedade que tem o Identificador listado na coluna Property da tabela Control.
Determina se a propriedade associada a esse controle é indiretamente referenciada.
Inteiro 0x00000000 0x00000010
A propriedade associada ao controle é um valor de cadeia de caracteres. A propriedade associada ao controle é um valor inteiro.
Inclua esse bit na palavra de bit da coluna Attributes da tabela Control para definir esse atributo na criação do controle.
RTLRO 0x00000000 0x00000020
O texto no controle é exibido na ordem de leitura da esquerda para a direita. O texto no controle é exibido na ordem de leitura da direita para a esquerda.
RightAligned 0x00000000 0x00000040
O texto no controle é alinhado à esquerda. O texto no controle é alinhado à direita.
PushLike 0x00000000 0x00020000
O controle é desenhado com sua aparência habitual. O controle tem o estilo BS_PUSHLIKE e é desenhado para aparecer como um botão de ação.
Inclua esse bit na palavra de bit da coluna Attributes da tabela Control para definir esse atributo na criação do controle.

Comentários

Esse controle pode ser criado a partir da classe BUTTON usando a função CreateWindowEx. Ele tem os estilos BS_CHECKBOX, WS_TABSTOP, WS_GROUP, WS_CHILD e BS_MULTILINE.