TextBoxBase.Select(Int32, Int32) Methode

  • Referenz

Definition

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

Wählt einen Textbereich im Textfeld aus.

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)

Parameter

start
Int32

Die Position des ersten Zeichens in der aktuellen Textmarkierung im Textfeld.

length
Int32

Die Anzahl der zu markierenden Zeichen.

Ausnahmen

ArgumentOutOfRangeException

Der Wert des start-Parameters ist kleiner als 0 (null).

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse verwendet TextBox, um den Inhalt des Steuerelements für die Instanz des Worts "Fox" zu durchsuchen. Wenn der Code gefunden wurde, wählt der Code das Wort im Steuerelement mithilfe der Select Methode aus. In diesem Beispiel ist erforderlich, dass ein TextBox benannter textBox1 Name erstellt wurde und Text seine Eigenschaft den Satz "Der schnelle braune Fuchs springt über den lazy Hund."

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

Hinweise

Wenn Sie die Startposition auf das erste Zeichen im Text des Steuerelements festlegen möchten, legen Sie den start Parameter auf 0 fest. Sie können diese Methode verwenden, um eine Teilzeichenfolge von Text auszuwählen, z. B. wenn Sie den Text des Steuerelements durchsuchen und Informationen ersetzen.

Hinweis

Sie können das Caret programmgesteuert innerhalb des Textfelds verschieben, indem Sie den start Parameter auf die Position innerhalb des Textfelds festlegen, an der der Caret verschoben werden soll, und den length Parameter auf einen Wert von Null (0) festlegen. Das Textfeld muss den Fokus haben, damit der Caret verschoben werden kann.

Hinweis

Wenn diese Methode ohne Parameter aufgerufen wird, wird eine alternative Methode verwendet. Diese alternative Methode erbt von der Control Klasse. Wenn sie aufgerufen wird, legt er den Eingabefokus auf das Steuerelement fest und wählt den Inhalt des Steuerelements aus. Weitere Informationen finden Sie unter der Methode Control.Select.

Gilt für

Siehe auch