TextBoxBase.Select(Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Seleciona um intervalo de texto na caixa de texto.
public:
void Select(int start, int length);
public void Select (int start, int length);
override this.Select : int * int -> unit
Public Sub Select (start As Integer, length As Integer)
Parâmetros
- start
- Int32
A posição do primeiro caractere na seleção de texto atual na caixa de texto.
- length
- Int32
O número de caracteres a serem selecionados.
Exceções
O valor do parâmetro start
é menor que zero.
Exemplos
O exemplo de código a seguir usa TextBox, uma classe derivada, para pesquisar o conteúdo do controle para a instância da palavra "fox". Se encontrado, o código seleciona a palavra no controle usando o Select método. Este exemplo requer que um TextBox nomeado textBox1
tenha sido criado e sua Text propriedade contenha a frase "A raposa marrom rápida pula sobre o cão preguiçoso".
public:
void SelectMyString()
{
// Create a string to search for the word "fox".
String^ searchString = "fox";
// Determine the starting location of the word "fox".
int index = textBox1->Text->IndexOf( searchString, 16, 3 );
// Determine if the word has been found and select it if it was.
if ( index != -1 )
{
// Select the string using the index and the length of the string.
textBox1->Select( index,searchString->Length );
}
}
public void SelectMyString()
{
// Create a string to search for the word "fox".
String searchString = "fox";
// Determine the starting location of the word "fox".
int index = textBox1.Text.IndexOf(searchString, 16, 3);
// Determine if the word has been found and select it if it was.
if (index != -1)
{
// Select the string using the index and the length of the string.
textBox1.Select(index, searchString.Length);
}
}
Public Sub SelectMyString()
' Create a string to search for the word "fox".
Dim searchString As String = "fox"
' Determine the starting location of the word "fox".
Dim index As Integer = textBox1.Text.IndexOf(searchString, 16, 3)
' Determine if the word has been found and select it if it was.
If index <> - 1 Then
' Select the string using the index and the length of the string.
textBox1.Select(index, searchString.Length)
End If
End Sub
Comentários
Se você quiser definir a posição inicial para o primeiro caractere no texto do controle, defina o start
parâmetro como 0. Você pode usar esse método para selecionar uma subcadeia de caracteres de texto, como ao pesquisar o texto do controle e substituir informações.
Observação
Você pode mover programaticamente o cursor dentro da caixa de texto definindo o start
parâmetro para a posição dentro da caixa de texto para a qual deseja que o cursor se mova e defina o length
parâmetro como um valor zero (0). A caixa de texto deve ter foco para que o cursor seja movido.
Observação
Se esse método for chamado sem parâmetros, um método alternativo será usado. Esse método alternativo herda da Control classe. Quando chamado, ele define o foco de entrada para o controle e seleciona o conteúdo do controle. Para obter mais informações, consulte o método Control.Select.