Compartilhar via


Propriedade TextBox.SelText (Access)

A propriedade SelText retorna uma cadeia de caracteres contendo o texto selecionado. Cadeia de caracteres de leitura/gravação.

Sintaxe

expressão. SelText

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

Comentários

Se nenhum texto estiver selecionado, a propriedade SelText contém um valor Nulo.

A propriedade SelText usa uma expressão de cadeia de caracteres que contém o texto selecionado no controle. Se o controle contiver texto selecionado quando essa propriedade estiver definida, o texto selecionado é substituído pela nova configuração SelText.

Para definir ou retornar essa propriedade para um controle, o controle deve ter o foco. Para mover o foco para um controle, use o método SetFocus.

Exemplo

O exemplo a seguir utiliza dois procedimentos de evento para localizar um texto especificado pelo usuário. O texto a ser pesquisado é definido no procedimento de evento Load do formulário. O procedimento de evento Clique no botão Localizar (que o usuário clica para iniciar a pesquisa) solicita ao usuário que o texto pesquise e selecione o texto na caixa de texto se a pesquisa for bem-sucedida.

Sub Form_Load() 
 Dim ctlTextToSearch As Control 
 Set ctlTextToSearch = Forms!Form1!TextBox1 
 ctlTextToSearch.SetFocus ' SetFocus to text box. 
 ctlTextToSearch.SelText = "This company places large orders " _ 
 & "twice a year for garlic, oregano, chilies and cumin." 
End Sub 
 
Sub Find_Click() 
 Dim strSearch As String, intWhere As Integer 
 Dim ctlTextToSearch As Control 
 ' Get search string from user. 
 With Me!Textbox1 
 strSearch = InputBox("Enter text to find:") 
 ' Find string in text. 
 intWhere = InStr(.Value, strSearch) 
 If intWhere Then 
 ' If found. 
 .SetFocus 
 .SelStart = intWhere - 1 
 .SelLength = Len(strSearch) 
 Else 
 ' Notify user. 
 MsgBox "String not found." 
 End If 
 End With 
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.