Compartilhar via


Objeto ToggleButton (Script do Outlook Forms)

Mostra o estado de seleção de um item.

Comentários

Utilize um ToggleButton para mostrar se um item está selecionado. Se um ToggleButton estiver vinculado a uma origem de dados, o ToggleButton mostrará o valor atual dessa origem de dados como Yes/No, True/False, On/Off ou alguma outra opção de duas configurações. Se o usuário selecionar o ToggleButton, a configuração atual será Yes, True ou On. Se o usuário não selecionar o ToggleButton, a configuração será No, False ou Off. Se o ToggleButton estiver vinculado a uma origem de dados, alterar a configuração altera o valor dessa origem de dados. Um ToggleButton desativado mostra um valor, mas é esmaecido e não permite alterações a partir da interface de usuário.

O ToggleButton também pode ser usado dentro de um Frame para selecionar um ou mais grupos de itens relacionados. Por exemplo, você pode criar um formulário de pedido com uma lista de itens disponíveis e um ToggleButton antecedendo cada item. O usuário poderá selecionar um item específico selecionando o ToggleButton apropriado.

A propriedade padrão de um ToggleButton é a propriedade Value.

O único evento de um ToggleButton é o evento Click.

Eventos

Nome Descrição
Click Occurs when the user definitively selects a value for the control that has more than one possible value.

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 ToggleButton 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 ToggleButton. Leitura/gravação.
Valor Returns or sets a Variant that specifies whether the toggle button 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.