TextBoxBase.Select(Int32, Int32) Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

ArgumentOutOfRangeException

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.

Aplica-se a

Confira também