TextBoxBase.ScrollToCaret Methode

public:
 void ScrollToCaret();

public void ScrollToCaret();

member this.ScrollToCaret : unit -> unit

Public Sub ScrollToCaret ()

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Keys Enumeration und der ScrollToCaret Methode veranschaulicht, um sicherzustellen, dass die durch das Caret dargestellte Texteinfügemarke immer auf dem Bildschirm sichtbar ist, nachdem die EINGABETASTE gedrückt wurde. Zum Ausführen des Beispiels fügen Sie den folgenden Code in ein Formular mit einem aufgerufenen TextBoxTextBox1 Steuerelement und einem aufgerufenen RichTextBoxSteuerelement einRichTextBox1. Dieses Beispiel erfordert, dass die Ereignisbehandlungsmethode dem KeyDown Ereignis zugeordnet wurde.

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.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();
    }
}

'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

Hinweise

Mit dieser Methode können Sie den Inhalt des Steuerelements scrollen, bis sich das Caret innerhalb des sichtbaren Bereichs des Steuerelements befindet. Wenn das Caret unterhalb des sichtbaren Bereichs des Steuerelements positioniert ist, scrollt die ScrollToCaret Methode im Inhalt des Steuerelements, bis das Caret am unteren Rand des Steuerelements sichtbar ist. Wenn das Caret oberhalb des sichtbaren Bereichs des Steuerelements positioniert ist, führt diese Methode einen Bildlauf durch den Inhalt des Steuerelements aus, bis das Caret oben im Steuerelement sichtbar ist. Sie können diese Methode in einem mehrzeiligen Textfeld verwenden, um sicherzustellen, dass sich der aktuelle Texteinstiegspunkt innerhalb des sichtbaren Bereichs des Steuerelements befindet.