Objeto CheckBox (script de formulários do Outlook)CheckBox object (Outlook Forms Script)

Exibe o estado de seleção de um item.Displays the selection state of an item.

ComentáriosRemarks

Use uma caixa de seleção para permitir que o usuário escolha entre dois valores como Sim/não, verdadeiro/falsoou ativado/desativado.Use a CheckBox to give the user a choice between two values such as Yes/No, True/False, or On/Off. Quando o usuário seleciona uma caixa de seleção, ele exibe uma marca especial (como um X) e sua configuração atual é Sim, verdadeiroou ligado.When the user selects a CheckBox, it displays a special mark (such as an X) and its current setting is Yes, True, or On. Se o usuário não selecionar a caixa de seleção, ela estará vazia e sua configuração será não, falsoou desativado.If the user does not select the CheckBox, it is empty and its setting is No, False, or Off. Dependendo do valor da propriedade TripleState , uma caixa de seleção também pode ter um valor nulo .Depending on the value of the TripleState property, a CheckBox can also have a Null value.

Se um CheckBox estiver ligado a uma fonte de dados, a alteração da configuração alterará o valor dessa fonte.If a CheckBox is bound to a data source, changing the setting changes the value of that source. 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.A disabled CheckBox shows the current value, but is dimmed and does not allow changes to the value from the user interface.

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.You can also use check boxes inside a group box to select one or more of a group of related items. Por exemplo, você pode criar um formulário de pedido que contenha uma lista de itens disponíveis, com um CheckBox precedendo cada item.For example, you can create an order form that contains a list of available items, with a CheckBox preceding each item. O usuário poderá selecionar um determinado item ou itens específicos, marcando o CheckBox correspondente.The user can select a particular item or items by checking the corresponding CheckBox.

A propriedade padrão de um CheckBox é a propriedade Value.The default property of a CheckBox is the Value property.

O ListBox também permite que você coloque uma marca de seleção nas opções selecionadas.The ListBox also lets you put a check mark by selected options. Dependendo do aplicativo, você poderá usar ListBox, em vez de usar um grupo de controles CheckBox.Depending on your application, you can use the ListBox instead of using a group of CheckBox controls.

EventosEvents

NomeName DescriçãoDescription
ClickClick Occurs when the user clicks inside the control.Occurs when the user clicks inside the control.

PropriedadesProperties

NomeName DescriçãoDescription
AcceleratorAccelerator Returns or sets the accelerator key for a control.Returns or sets the accelerator key for a control. Leitura/gravação.Read/write.
AlignmentAlignment Returns or sets an Integer that indicates the position of a control relative to its caption.Returns or sets an Integer that indicates the position of a control relative to its caption. Leitura/gravação.Read/write.
AutoSizeAutoSize Returns or sets a Boolean that specifies whether an object automatically resizes to display its entire contents.Returns or sets a Boolean that specifies whether an object automatically resizes to display its entire contents. Leitura/gravação.Read/write.
BackColorBackColor Returns or sets a Long that specifies the background color of the object.Returns or sets a Long that specifies the background color of the object. Leitura/gravação.Read/write.
BackStyleBackStyle Returns or sets an Integer that specifies the background style for an object.Returns or sets an Integer that specifies the background style for an object. Leitura/gravação.Read/write.
CaptionCaption Returns or sets a String that appears on an object to identify or describe it.Returns or sets a String that appears on an object to identify or describe it. Leitura/gravação.Read/write.
EnabledEnabled Returns or sets a Boolean that specifies whether a control can receive the focus and respond to user-generated events.Returns or sets a Boolean that specifies whether a control can receive the focus and respond to user-generated events. Leitura/gravação.Read/write.
ForeColorForeColor Returns or sets a Long that specifies the foreground color of an object.Returns or sets a Long that specifies the foreground color of an object. Leitura/gravação.Read/write.
GroupNameGroupName Returns or sets a String that identifies a group of mutually exclusive CheckBox controls.Returns or sets a String that identifies a group of mutually exclusive CheckBox controls. Leitura/gravação.Read/write.
LockedLocked Returns or sets a Boolean that specifies whether a control can be edited.Returns or sets a Boolean that specifies whether a control can be edited. Leitura/gravação.Read/write.
MouseIconMouseIcon Returns a String that represents the full path name of a custom icon that is to be assigned to the control.Returns a String that represents the full path name of a custom icon that is to be assigned to the control. Somente leitura.Read-only.
MousePointerMousePointer Returns or sets an Integer that specifies the type of pointer displayed when the user positions the mouse over a particular object.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.Read/write.
PicturePicture Returns a String that specifies the full path name of a bitmap to display on a control.Returns a String that specifies the full path name of a bitmap to display on a control. Read-only.Read-only.
PicturePositionPicturePosition Retorna ou define um inteiro que especifica o local da imagem em relação à sua legenda.Returns or sets an Integer that specifies the location of the picture relative to its caption. Leitura/gravação.Read/write.
SpecialEffectSpecialEffect Returns or sets an Integer that specifies the visual appearance of an object.Returns or sets an Integer that specifies the visual appearance of an object. Leitura/gravação.Read/write.
TextAlignTextAlign Returns or sets an Integer that specifies how text is aligned in a control.Returns or sets an Integer that specifies how text is aligned in a control. Leitura/gravação.Read/write.
TripleStateTripleState Returns or sets a Boolean that determines whether a user can specify, from the user interface, the Null state for a CheckBox.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.Read/write.
ValorValue Returns or sets a Variant that specifies whether the check box is selected.Returns or sets a Variant that specifies whether the check box is selected. Leitura/gravação.Read/write.
WordWrapWordWrap 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.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. Read/write.Read/write.

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.