Propriedade TextBox.Text (Access)

Use a propriedade Text para definir ou retornar o valor de texto contido em uma caixa de texto. String de leitura/gravação.

Sintaxe

expressão. Texto

Expressão Uma variável que representa um objeto TextBox .

Comentários

Você pode definir a propriedade Text para o texto que deseja exibir no controle. Você também pode usar a propriedade Text para ler o texto atualmente no controle.

Observação

[!OBSERVAçãO] Para definir ou retornar a propriedade Text de um controle, o controle deve ter o foco, ocorrerá um erro. Para mover o foco para um controle, você pode usar o método SetFocus ou ação GoToControl.

Enquanto o controle tem o foco, a propriedade Text contém os dados de texto atualmente no controle; a propriedade Value contém os últimos dados salvos para o controle. Quando você move o foco para outro controle, os dados do controle são atualizados, e a propriedade Value é definida como esse novo valor. A configuração da propriedade de texto, em seguida, está indisponível até que o controle recebe o foco novamente. Se você usar o comando Salvar registro no menu registros para salvar os dados no controle sem mover o foco, a propriedade Text e configurações de propriedade do valor será o mesmo.

Exemplo

O exemplo a seguir usa a propriedade Text para habilitar um botão Next chamado btnNext sempre que o usuário insere texto em uma caixa de texto chamada txtName. Sempre que a caixa de texto estiver vazia, o botão Avançar será desabilitado.

Sub txtName_Change() 
 btnNext.Enabled = Len(Me!txtName.Text & "")<>0 
End Sub

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.