TextBoxBase.SelectionStart Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Anfangspunkt des im Textfeld ausgewählten Texts ab oder legt diesen fest.
public:
property int SelectionStart { int get(); void set(int value); };[System.ComponentModel.Browsable(false)]
public int SelectionStart { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.SelectionStart : int with get, setPublic Property SelectionStart As IntegerEigenschaftswert
Die Anfangsposition des im Textfeld markierten Texts.
- Attribute
Ausnahmen
Der zugewiesene Wert ist kleiner als Null.
Beispiele
Beispiel 1
Im folgenden Codebeispiel wird eine abgeleitete Klasse verwendet TextBox. Es stellt Ereignishandler für Objekte bereit ClickMenuItem , die Cut-, Copy-, Paste- und Rückgängig-Vorgänge ausführen. Dieses Beispiel erfordert, dass ein benanntes TextBoxtextBox1 Steuerelement erstellt wurde.
private:
void Menu_Copy( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Ensure that text is selected in the text box.
if ( textBox1->SelectionLength > 0 )
{
// Copy the selected text to the Clipboard.
textBox1->Copy();
}
}
void Menu_Cut( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Ensure that text is currently selected in the text box.
if ( !textBox1->SelectedText->Equals( "" ) )
{
// Cut the selected text in the control and paste it into the Clipboard.
textBox1->Cut();
}
}
void Menu_Paste( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Determine if there is any text in the Clipboard to paste into the text box.
if ( Clipboard::GetDataObject()->GetDataPresent( DataFormats::Text ))
{
// Determine if any text is selected in the text box.
if ( textBox1->SelectionLength > 0 )
{
// Ask user if they want to paste over currently selected text.
if ( MessageBox::Show( "Do you want to paste over current selection?",
"Cut Example", MessageBoxButtons::YesNo ) == ::DialogResult::No )
{
// Move selection to the point after the current selection and paste.
textBox1->SelectionStart = textBox1->SelectionStart + textBox1->SelectionLength;
}
}
// Paste current text in Clipboard into text box.
textBox1->Paste();
}
}
void Menu_Undo( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Determine if last operation can be undone in text box.
if ( textBox1->CanUndo)
{
// Undo the last operation.
textBox1->Undo();
// Clear the undo buffer to prevent last action from being redone.
textBox1->ClearUndo();
}
}
private void Menu_Copy(System.Object sender, System.EventArgs e)
{
// Ensure that text is selected in the text box.
if(textBox1.SelectionLength > 0)
// Copy the selected text to the Clipboard.
textBox1.Copy();
}
private void Menu_Cut(System.Object sender, System.EventArgs e)
{
// Ensure that text is currently selected in the text box.
if(textBox1.SelectedText != "")
// Cut the selected text in the control and paste it into the Clipboard.
textBox1.Cut();
}
private void Menu_Paste(System.Object sender, System.EventArgs e)
{
// Determine if there is any text in the Clipboard to paste into the text box.
if (Clipboard.GetDataObject().GetDataPresent(DataFormats.Text))
{
// Determine if any text is selected in the text box.
if(textBox1.SelectionLength > 0)
{
// Ask user if they want to paste over currently selected text.
if(MessageBox.Show("Do you want to paste over current selection?", "Cut Example", MessageBoxButtons.YesNo) == DialogResult.No)
// Move selection to the point after the current selection and paste.
textBox1.SelectionStart = textBox1.SelectionStart + textBox1.SelectionLength;
}
// Paste current text in Clipboard into text box.
textBox1.Paste();
}
}
private void Menu_Undo(System.Object sender, System.EventArgs e)
{
// Determine if last operation can be undone in text box.
if (textBox1.CanUndo)
{
// Undo the last operation.
textBox1.Undo();
// Clear the undo buffer to prevent last action from being redone.
textBox1.ClearUndo();
}
}
Private Sub Menu_Copy(sender As System.Object, e As System.EventArgs)
' Ensure that text is selected in the text box.
If textBox1.SelectionLength > 0 Then
' Copy the selected text to the Clipboard.
textBox1.Copy()
End If
End Sub
Private Sub Menu_Cut(sender As System.Object, e As System.EventArgs)
' Ensure that text is currently selected in the text box.
If textBox1.SelectedText <> "" Then
' Cut the selected text in the control and paste it into the Clipboard.
textBox1.Cut()
End If
End Sub
Private Sub Menu_Paste(sender As System.Object, e As System.EventArgs)
' Determine if there is any text in the Clipboard to paste into the text box.
If Clipboard.GetDataObject().GetDataPresent(DataFormats.Text) = True Then
' Determine if any text is selected in the text box.
If textBox1.SelectionLength > 0 Then
' Ask user if they want to paste over currently selected text.
If MessageBox.Show("Do you want to paste over current selection?", _
"Cut Example", MessageBoxButtons.YesNo) = DialogResult.No Then
' Move selection to the point after the current selection and paste.
textBox1.SelectionStart = textBox1.SelectionStart + _
textBox1.SelectionLength
End If
End If
' Paste current text in Clipboard into text box.
textBox1.Paste()
End If
End Sub
Private Sub Menu_Undo(sender As System.Object, e As System.EventArgs)
' Determine if last operation can be undone in text box.
If textBox1.CanUndo = True Then
' Undo the last operation.
textBox1.Undo()
' Clear the undo buffer to prevent last action from being redone.
textBox1.ClearUndo()
End If
End Sub
Beispiel 2
Im folgenden Beispiel wird die SelectionStart Eigenschaft eines Objekts TextBox festgelegt, ReadOnly das sie als Focus erstes angibt.
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
this.button1.Click += new System.EventHandler(this.ButtonClickWork);
}
private void ButtonClickWork(object sender, EventArgs e)
{
this.textBox1.Text = "Hello world!";
this.textBox1.ReadOnly = true;
this.textBox1.Focus();
this.textBox1.SelectionStart = this.textBox1.SelectionStart + 1;
this.textBox1.SelectionLength = 1;
}
}
Public Class Form1
Public Shared Sub Main()
End Sub
Private Sub ButtonClickWork(ByVal sender As System.Object, ByVal e As System.EventArgs) _
Handles Button1.Click
Me.TextBox1.Text = "Hello world!"
Me.TextBox1.ReadOnly = True
Me.TextBox1.Focus()
Me.TextBox1.SelectionStart = Me.TextBox1.SelectionStart + 1
Me.TextBox1.SelectionLength = 1
End Sub
End Class
Hinweise
Wenn im Steuerelement kein Text markiert ist, gibt diese Eigenschaft die Einfügemarke oder das Caretzeichen für neuen Text an. Wenn Sie diese Eigenschaft auf eine Position festlegen, die über die Länge des Texts im Steuerelement hinausgeht, wird die Startposition der Auswahl nach dem letzten Zeichen platziert. Wenn Text im Textfeld-Steuerelement markiert ist, kann das Ändern dieser Eigenschaft den Wert der SelectionLength Eigenschaft verringern. Wenn der verbleibende Text im Steuerelement nach der durch die SelectionStart Eigenschaft angegebenen Position kleiner als der Wert der SelectionLength Eigenschaft ist, wird der Wert der SelectionLength Eigenschaft automatisch verringert. Der Wert der SelectionStart Eigenschaft verursacht niemals eine Erhöhung der SelectionLength Eigenschaft.
Sie können die Auswahl programmgesteuert innerhalb des Textfelds verschieben, indem Sie die SelectionStart Eigenschaften und die SelectionLength Eigenschaften festlegen.
Sie können das Caret programmgesteuert innerhalb des Textfelds verschieben, indem Sie die SelectionStart Position innerhalb des Textfelds festlegen, an die das Caret verschoben werden soll, und die SelectionLength Eigenschaft auf einen Wert von Null (0) festlegen.
Der TextBox Fokus muss den Fokus haben, damit die Auswahl oder das Caret verschoben werden kann. Sie können die SelectionStart Eigenschaft eines TextBox objekts festlegen, ReadOnly indem Sie sie als Focus erstes festlegen.
