Compartilhar via


Propriedade BoundValue

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

Sintaxe

objeto. BoundValue [= Variante ]

A sintaxe da propriedade BoundValue tem as seguintes partes:

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

Configurações

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

É nulo. Indica que o item está num estado nulo, não selecionado nem limpo.

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

0 Falso. Indica que o item está desmarcado.
Botão de Opção O mesmo que a Caixa de Verificação.
Botão de Alternar O mesmo que a Caixa de Verificação.
Barra de Deslocamento Um número inteiro entre os valores especificados para as propriedades Máx e Mín .
SpinButton O mesmo que a Barra de Deslocamento.
Caixa de Combinação, Caixa de Listagem O valor na Coluna Vinculada das linhas atualmente selecionadas.
CommandButton Sempre Falso.
Várias Páginas Um número 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 controlo que tem o foco.

Os conteúdos das propriedades BoundValue e Value são idênticos na maioria das vezes. Quando o utilizador edita um controlo para que o respetivo valor seja alterado, os conteúdos de BoundValue e Value são diferentes até que a alteração seja final.

Vários itens ocorrem quando o utilizador altera o valor de um controlo. Por exemplo, se um utilizador alterar o texto numa Caixa de Texto, ocorrem os seguintes procedimentos:

  1. O evento Change é iniciado. Neste momento, a propriedade Valor 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 utilizado 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.