TextBoxBase.Select(Int32, Int32) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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)
Parameters
- 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.
Exceptions
The value of the start
parameter is less than zero.
Examples
The following code example uses TextBox, a derived class, to search the contents of the control for the instance of the word "fox". If found, the code selects the word in the control using the Select method. 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
Remarks
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.
Note
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.
Note
If this method is called without any parameters, an alternative method is used. 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. For more information, see the Control.Select method.
Applies to
See also
Athugasemdir
https://aka.ms/ContentUserFeedback.
Væntanlegt: Á árinu 2024 munum við hætta með GitHub-mál sem ábendingaleið fyrir efni og skipta því út fyrir nýtt ábendingakerfi. Frekari upplýsingar er að finna hér:Senda inn og skoða endurgjöf fyrir