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.