Objeto OptionButton (Script do Outlook Forms)

Mostra o status de seleção de um item em um grupo de opções.

Comentários

Use um OptionButton para mostrar se um item individual de um grupo está selecionado. Observe que cada OptionButton em um controle Frame é mutuamente exclusivo.

Se um OptionButton estiver ligado a uma fonte de dados, o OptionButton poderá mostrar o valor da fonte de dados como Yes/No, True/False ou On/Off. Se o usuário selecionar o OptionButton, a configuração atual será Yes, True ou On. Se o usuário não selecionar o OptionButton, a configuração será No, False ou Off. Por exemplo, um OptionButton em um aplicativo de controle de estoque pode mostrar se um item foi descontinuado. Se o OptionButton estiver ligado a uma fonte de dados, alterar a configuração altera o valor dessa fonte de dados. Um OptionButton desabilitado é esmaecido e não mostra um valor.

Dependendo do valor da propriedade TripleState , um OptionButton também pode ter um valor Null .

Um OptionButton também pode ser usado dentro de uma caixa de grupo 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 OptionButton antecedendo cada item. O usuário pode selecionar um item específico verificando a opção OptionButtonOptionButton correspondente.

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

Eventos

Nome Descrição
Click Ocorre quando o usuário seleciona definitivamente um valor para o controle que tem mais de um valor possível ou quando o valor é alterado para True.

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 OptionButton 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 the OptionButton supports the Null state. Leitura/gravação.
Valor Returns or sets a Variant that specifies whether the option 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.