Propriedade BoundValue

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

Sintaxe

objeto de teste. BoundValue [= Variant ]

A sintaxe da propriedade BoundValue tem estas partes:

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

Configurações

Control Descrição
CheckBox Um valor inteiro que indica se o item está selecionado:

Nulo. Indica que o item está em um estado nulo, não selecionado nem desmarcado.

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

0 False. Indica que o item está desmarcado.
OptionButton O mesmo que a caixa de seleção.
ToggleButton O mesmo que a caixa de seleção.
Barra de rolagem Um número inteiro entre os valores especificados para as propriedades Max e Min .
Botão de rotação Igual à Barra de rolagem.
ComboBox, ListBox O valor em BoundColumn das linhas selecionadas no momento.
CommandButton Sempre falso.
MultiPage Um número inteiro que indica a página ativa no momento.

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 se aplica ao controle que tem o foco.

O conteúdo das propriedades BoundValue e Value é idêntico na maioria das vezes. Quando o usuário edita um controle para que seu valor seja alterado, o conteúdo de BoundValue e Value será 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, ocorrerão os seguintes problemas:

  1. O evento Change é 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 para BoundValue e Value são novamente idênticos, contendo o novo texto.

BoundValue não pode ser usado com uma caixa de listagem de seleção múltipla.

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.