TextBoxBase.Select(Int32, Int32) Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
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 carácter na seleção de texto atual dentro da caixa de texto.

length
Int32

O número de caracteres a selecionar.

Exceções

ArgumentOutOfRangeException

O valor do start parâmetro é inferior a zero.

Exemplos

O exemplo de código seguinte utiliza TextBox, uma classe derivada, para pesquisar no conteúdo do controlo a instância da palavra "fox". Se for encontrado, o código seleciona a palavra no controlo usando o Select método. Este exemplo exige que um TextBox nome textBox1 tenha sido criado e que a sua Text propriedade contenha a frase "A raposa castanha rápida salta por cima do 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

Observações

Se quiseres definir a posição inicial para o primeiro carácter no texto do controlo, define o start parâmetro para 0. Pode usar este método para selecionar uma subcadeia de texto, como ao pesquisar no texto do controlo e substituir informação.

Note

Podes mover programaticamente o caret dentro da caixa de texto definindo o start parâmetro para a posição dentro da caixa de texto para onde queres que o caret se mova e definir o length parâmetro para um valor zero (0). A caixa de texto deve ter foco para que o caret possa ser movido.

Note

Se este método for chamado sem quaisquer parâmetros, é utilizado um método alternativo. Este método alternativo herda da Control classe. Quando chamado, define o foco de entrada para o controlo e seleciona o conteúdo do controlo. Para obter mais informações, consulte o método Control.Select.

Aplica-se a

Ver também