TextBoxBase.ScrollToCaret-Methode

Führt einen Bildlauf durch den Inhalt des Steuerelements bis zur aktuellen Position der Einfügemarke durch.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Sub ScrollToCaret
'Usage
Dim instance As TextBoxBase

instance.ScrollToCaret

public void ScrollToCaret ()

public:
void ScrollToCaret ()

public void ScrollToCaret ()

public function ScrollToCaret ()

Hinweise

Mit dieser Methode können Sie einen Bildlauf durch den Inhalt des Steuerelements durchführen, bis die Einfügemarke im Steuerelement angezeigt wird. Wenn die Einfügemarke unterhalb des angezeigten Bereichs des Steuerelements positioniert ist, führt die ScrollToCaret-Methode einen Bildlauf durch den Inhalt des Steuerelements durch, bis die Einfügemarke am unteren Rand des Steuerelements angezeigt wird. Wenn die Einfügemarke über dem angezeigten Bereich des Steuerelements positioniert ist, führt die Methode einen Bildlauf durch den Inhalt des Steuerelements durch, bis die Einfügemarke am oberen Rand des Steuerelements angezeigt wird. Sie können diese Methode in einem mehrzeiligen Textfeld verwenden, um sicherzustellen, dass sich der aktuelle Einstiegspunkt für Text im angezeigten Bereich des Steuerelements befindet.

Beispiel

Das folgende Codebeispiel veranschaulicht die Verwendung der Keys-Enumeration und der ScrollToCaret-Methode. Zum Ausführen des Beispiels fügen Sie den folgenden Code in ein Formular ein, das ein TextBox-Steuerelement mit dem Namen TextBox1 und ein RichTextBox-Steuerelement mit dem Namen RichTextBox1 enthält. In diesem Beispiel ist es erforderlich, dass dem KeyDown-Ereignis die Methode zur Ereignisbehandlung zugeordnet wurde.

'Handles the Enter key being pressed while TextBox1 has focus. 
Private Sub TextBox1_KeyDown(ByVal sender As Object, _
    ByVal e As KeyEventArgs) Handles TextBox1.KeyDown
    TextBox1.HideSelection = False
    If e.KeyCode = Keys.Enter Then
        e.Handled = True

        ' Copy the text from TextBox1 to RichTextBox1, add a CRLF after 
        ' the copied text, and keep the caret in view.
        RichTextBox1.SelectedText = TextBox1.Text + _
            Microsoft.VisualBasic.vbCrLf
        RichTextBox1.ScrollToCaret()
    End If
End Sub

//Handles the Enter key being pressed while TextBox1 has focus. 
private void TextBox1_KeyDown(object sender, KeyEventArgs e)
{
    TextBox1.HideSelection = false;
    if (e.KeyCode==Keys.Enter)
    {
        e.Handled = true;

        // Copy the text from TextBox1 to RichTextBox1, add a CRLF after 
        // the copied text, and keep the caret in view.
        RichTextBox1.SelectedText = TextBox1.Text + "\r\n";
        RichTextBox1.ScrollToCaret();
    }
}

private:
   //Handles the Enter key being pressed while TextBox1 has focus. 
   void TextBox1_KeyDown( Object^ /*sender*/, KeyEventArgs^ e )
   {
      TextBox1->HideSelection = false;
      if ( e->KeyCode == Keys::Enter )
      {
         e->Handled = true;

         // Copy the text from TextBox1 to RichTextBox1, add a CRLF after 
         // the copied text, and keep the caret in view.
         RichTextBox1->SelectedText = String::Concat( TextBox1->Text, "\r\n" );
         RichTextBox1->ScrollToCaret();
      }
   }

//Handles the Enter key being pressed while TextBox1 has focus. 
private void textBox1_KeyDown(Object sender, KeyEventArgs e)
{
    textBox1.set_HideSelection(false);
    if (e.get_KeyCode().Equals(Keys.Enter)) {
        e.set_Handled(true);
        // Copy the text from textBox1 to richTextBox1, add a CRLF after 
        // the copied text, and keep the caret in view.
        richTextBox1.set_SelectedText(textBox1.get_Text() + "\r\n");
        richTextBox1.ScrollToCaret();
    }
} //textBox1_KeyDown

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TextBoxBase-Klasse
TextBoxBase-Member
System.Windows.Forms-Namespace