Objeto CheckBox (Script do Outlook Forms)
Exibe o estado de seleção de um item.
Comentários
Use uma Caixa de Seleção para dar ao usuário uma opção entre dois valores como Sim/Não, True/False ou Ativado/Desativado. Quando o usuário seleciona uma Caixa de Seleção, ela exibe uma marca especial (como um X) e sua configuração atual é Sim, True ou Ativado. Se o usuário não selecionar a Caixa de Seleção, ela estará vazia e sua configuração será Não, False ou Desativada. Dependendo do valor da propriedade TripleState , uma Caixa de Seleção também pode ter um valor Null .
Se um CheckBox estiver ligado a uma fonte de dados, a alteração da configuração alterará o valor dessa fonte. Um CheckBox desabilitado mostra o valor atual, mas fica esmaecido e não permite alterações do valor a partir da interface do usuário.
Também é possível usar caixas de seleção no interior de uma caixa de grupo para selecionar um ou mais grupos de itens relacionados. Por exemplo, você pode criar um formulário de pedido que contenha uma lista de itens disponíveis, com um CheckBox precedendo cada item. O usuário poderá selecionar um determinado item ou itens específicos, marcando o CheckBox correspondente.
A propriedade padrão de um CheckBox é a propriedade Value.
O ListBox também permite que você coloque uma marca de seleção por opções selecionadas. Dependendo do aplicativo, você poderá usar ListBox, em vez de usar um grupo de controles CheckBox.
Eventos
| Nome | Descrição |
|---|---|
| Click | Occurs when the user clicks inside the control. |
Propriedades
| Nome | Descrição |
|---|---|
| Accelerator | Returns or sets the accelerator key for a control. Leitura/gravação. |
| Alignment | Returns or sets an Integer that indicates the position of a control relative to its caption. Leitura/gravação. |
| AutoSize | Returns or sets a Boolean that specifies whether an object automatically resizes to display its entire contents. Leitura/gravação. |
| BackColor | Returns or sets a Long that specifies the background color of the object. Leitura/gravação. |
| BackStyle | Returns or sets an Integer that specifies the background style for an object. Leitura/gravação. |
| Caption | Returns or sets a String that appears on an object to identify or describe it. Leitura/gravação. |
| Enabled | Returns or sets a Boolean that specifies whether a control can receive the focus and respond to user-generated events. Leitura/gravação. |
| ForeColor | Returns or sets a Long that specifies the foreground color of an object. Leitura/gravação. |
| GroupName | Returns or sets a String that identifies a group of mutually exclusive CheckBox controls. Leitura/gravação. |
| Locked | Returns or sets a Boolean that specifies whether a control can be edited. Leitura/gravação. |
| MouseIcon | Returns a String that represents the full path name of a custom icon that is to be assigned to the control. Somente leitura. |
| MousePointer | Returns or sets an Integer that specifies the type of pointer displayed when the user positions the mouse over a particular object. Leitura/gravação. |
| Picture | Returns a String that specifies the full path name of a bitmap to display on a control. Somente leitura. |
| PicturePosition | Retorna ou define um Inteiro que especifica o local da imagem em relação à sua legenda. Leitura/gravação. |
| SpecialEffect | Returns or sets an Integer that specifies the visual appearance of an object. Leitura/gravação. |
| TextAlign | Returns or sets an Integer that specifies how text is aligned in a control. Leitura/gravação. |
| TripleState | Returns or sets a Boolean that determines whether a user can specify, from the user interface, the Null state for a CheckBox. Leitura/gravação. |
| Valor | Returns or sets a Variant that specifies whether the check box is selected. Leitura/gravação. |
| WordWrap | Returns or sets a Boolean that specifies whether the contents of a control automatically wrap at the end of a line and the control expands to fit the text. Leitura/gravação. |
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.