TextBoxBase.ScrollToCaret Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Führt einen Bildlauf durch den Inhalt des Steuerelements bis zur aktuellen Caretposition durch.

public:
 void ScrollToCaret();

public void ScrollToCaret ();

member this.ScrollToCaret : unit -> unit

Public Sub ScrollToCaret ()

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Keys -Enumeration und die ScrollToCaret -Methode verwendet werden, um sicherzustellen, dass die Texteinfügemarke, dargestellt durch das Caretzeichen, nach dem Drücken der EINGABETASTE immer auf dem Bildschirm sichtbar ist. Fügen Sie zum Ausführen des Beispiels den folgenden Code in ein Formular ein, das ein TextBox Steuerelement namens TextBox1 und ein RichTextBox Steuerelement namens enthält RichTextBox1. 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 Caretzeichen im sichtbaren Bereich des Steuerelements befindet. Wenn das Caretzeichen unterhalb des sichtbaren Bereichs des Steuerelements positioniert ist, führt die ScrollToCaret Methode einen Bildlauf durch den Inhalt des Steuerelements durch, bis das Caretzeichen am unteren Rand des Steuerelements sichtbar ist. Wenn das Caretzeichen über dem sichtbaren Bereich des Steuerelements positioniert ist, scrollt diese Methode durch den Inhalt des Steuerelements, 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.

Hinweis

Diese Methode hat keine Auswirkung, wenn das Steuerelement keinen Fokus hat oder das Caretzeichen bereits im sichtbaren Bereich des Steuerelements positioniert ist.