TextBoxBase.ScrollToCaret TextBoxBase.ScrollToCaret TextBoxBase.ScrollToCaret TextBoxBase.ScrollToCaret Method

Définition

Fait défiler le contenu du contrôle vers la position indiquée par le signe insertion.Scrolls the contents of the control to the current caret position.

public:
 void ScrollToCaret();
public void ScrollToCaret ();
member this.ScrollToCaret : unit -> unit
Public Sub ScrollToCaret ()

Exemples

L’exemple de code suivant montre comment utiliser l' Keys énumération et ScrollToCaret la méthode pour garantir que le point d’insertion de texte, représenté par le signe insertion, est toujours visible sur l’écran après que l’utilisateur a appuyé sur la touche entrée.The following code example demonstrates how to use the Keys enumeration and the ScrollToCaret method to ensure that the text insertion point, represented by the caret, is always visible on the screen after the ENTER key has been pressed. Pour exécuter l’exemple, collez le code suivant dans un formulaire contenant TextBox un contrôle TextBox1 nommé et RichTextBox un contrôle RichTextBox1appelé.To run the example, paste the following code in a form containing a TextBox control called TextBox1 and a RichTextBox control called RichTextBox1. Cet exemple requiert que la méthode de gestion des événements soit associée à l' KeyDown événement.This example requires that the event-handling method has been associated with the KeyDown event.

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

Remarques

Cette méthode vous permet de faire défiler le contenu du contrôle jusqu’à ce que le signe insertion se trouve dans la zone visible du contrôle.This method enables you to scroll the contents of the control until the caret is within the visible region of the control. Si le signe insertion se trouve sous la zone visible du contrôle, la ScrollToCaret méthode fait défiler le contenu du contrôle jusqu’à ce que le signe insertion soit visible au bas du contrôle.If the caret is positioned below the visible region of the control, the ScrollToCaret method will scroll the contents of the control until the caret is visible at the bottom of the control. Si le signe insertion est positionné au-dessus de la zone visible du contrôle, cette méthode fait défiler le contenu du contrôle jusqu’à ce que le signe insertion soit visible en haut du contrôle.If the caret is positioned above the visible region of the control, this method scrolls the contents of the control until the caret is visible at the top of the control. Vous pouvez utiliser cette méthode dans une zone de texte multiligne pour vous assurer que le point d’entrée de texte actuel se trouve dans la zone visible du contrôle.You can use this method in a multiline text box to ensure that the current text entry point is within the visible region of the control.

Notes

Cette méthode n’a aucun effet si le contrôle n’a pas le focus ou si le signe insertion est déjà positionné dans la zone visible du contrôle.This method has no effect if the control does not have focus or if the caret is already positioned in the visible region of the control.

S’applique à