TextBoxBase.Select(Int32, Int32) Метод

Определение

Выбирает диапазон текста в текстовом поле.Selects a range of text in the text box.

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)

Параметры

start
Int32

Положение первого символа в текущем выделении текста в текстовом поле.The position of the first character in the current text selection within the text box.

length
Int32

Число выделяемых символов.The number of characters to select.

Исключения

Значение параметра start меньше нуля.The value of the start parameter is less than zero.

Примеры

В следующем примере кода производный класс используется TextBoxдля поиска содержимого элемента управления для экземпляра слова «Fox».The following code example uses TextBox, a derived class, to search the contents of the control for the instance of the word "fox". Если объект найден, код выбирает слово в элементе управления с помощью Select метода.If found, the code selects the word in the control using the Select method. Для этого примера требуется, TextBox чтобы textBox1 было создано имя с именем Text , а его свойство содержит предложение «быстрые коричневые отработки отказа Fox через отложенную собака».This example requires that a TextBox named textBox1 has been created and its Text property contains the sentence "The quick brown fox jumps over the lazy dog."

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

Комментарии

Если вы хотите установить начальную точку в качестве первого символа в тексте элемента управления, присвойте start параметру значение 0.If you want to set the start position to the first character in the control's text, set the start parameter to 0. Этот метод можно использовать для выбора подстроки текста, например при поиске по тексту элемента управления и замене информации.You can use this method to select a substring of text, such as when searching through the text of the control and replacing information.

Примечание

Вы можете программно перемещать курсор внутри текстового поля, присвоив start параметру позицию в текстовом поле, куда нужно переместить курсор, и length присвоить параметру нулевое значение (0).You can programmatically move the caret within the text box by setting the start parameter to the position within the text box where you want the caret to move to and set the length parameter to a value of zero (0). Текстовое поле должно иметь фокус, чтобы переместить курсор.The text box must have focus in order for the caret to be moved.

Примечание

Если этот метод вызывается без параметров, используется альтернативный метод.If this method is called without any parameters, an alternative method is used. Этот альтернативный метод наследует от Control класса.This alternative method inherits from the Control class. При вызове он устанавливает фокус ввода на элемент управления и выбирает содержимое элемента управления.When called, it sets the input focus to the control and selects the contents of the control. Дополнительные сведения см. в описании метода Control.Select.For more information, see the Control.Select method.

Применяется к

Дополнительно