Compartilhar via


Propriedade BoundValue

Contém o valor de um controle quando esse controle recebe o foco.

Sintaxe

objeto. BoundValue [= Variant ]

A sintaxe da propriedade BoundValue tem estas partes:

Sair Descrição
objeto Obrigatório. Um objeto válido.
Variantes Opcional. O estado atual ou o conteúdo do controle.

Configurações

Controle Descrição
Checkbox Um valor inteiro que indica se o item está selecionado:

Null. Indica que o item está em um estado nulo, nem selecionado nem desmarcado.

-1 True. Indica que o item está selecionado.

0 False. Indica que o item está desmarcado.
Optionbutton O mesmo que CheckBox.
Togglebutton O mesmo que CheckBox.
Scrollbar Um inteiro entre os valores especificados para as propriedades Max e Min .
SpinButton O mesmo que ScrollBar.
ComboBox, ListBox O valor no BoundColumn das linhas selecionadas no momento.
Commandbutton Sempre False.
Multipágina Um inteiro que indica a página atualmente ativa.

Zero (0) indicates the first page. The maximum value is one less than the number of pages.
TextBox O texto na região de edição.

Comentários

BoundValue aplica-se ao controle que tem o foco.

O conteúdo das propriedades BoundValue e Value é idêntico na maior parte do tempo. Quando o usuário edita um controle para que seu valor seja alterado, o conteúdo de BoundValue e Value é diferente até que a alteração seja final.

Várias coisas ocorrem quando o usuário altera o valor de um controle. Por exemplo, se um usuário alterar o texto em um TextBox, as seguintes coisas ocorrerão:

  1. O evento Alterar é iniciado. Neste momento, a propriedade Value contém o novo texto e BoundValue contém o texto anterior.

  2. O evento BeforeUpdate é iniciado.

  3. O evento AfterUpdate é iniciado. Os valores de BoundValue e Value são novamente idênticos, contendo o novo texto.

BoundValue não pode ser usado com uma caixa de lista de várias seleções.

Confira também

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.