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 パラメーターの値が 0 未満です。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. この例では、 TextBoxtextBox1いう名前のが作成Textされ、そのプロパティに "quick brown fox は lazy dog にジャンプします。" という文が含まれている必要があります。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.

適用対象

こちらもご覧ください