TextBoxBase.ScrollToCaret Methode

public:
 void ScrollToCaret();

public void ScrollToCaret();

member this.ScrollToCaret : unit -> unit

Public Sub ScrollToCaret ()

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de opsomming en de Keys methode gebruikt om ervoor te zorgen dat de invoegpositie van de ScrollToCaret tekst, vertegenwoordigd door de caret, altijd zichtbaar is op het scherm nadat de ENTER-toets is ingedrukt. Als u het voorbeeld wilt uitvoeren, plakt u de volgende code in een formulier met een besturingselement dat wordt TextBox aangeroepen TextBox1 en een besturingselement met de RichTextBox naam RichTextBox1. Voor dit voorbeeld is vereist dat de methode voor gebeurtenisafhandeling is gekoppeld aan de KeyDown gebeurtenis.

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

Opmerkingen

Met deze methode kunt u de inhoud van het besturingselement schuiven totdat de caret zich in het zichtbare gebied van het besturingselement bevindt. Als de caret zich onder het zichtbare gebied van het besturingselement bevindt, schuift de ScrollToCaret methode de inhoud van het besturingselement totdat de caret onder aan het besturingselement zichtbaar is. Als de caret boven het zichtbare gebied van het besturingselement wordt geplaatst, schuift deze methode de inhoud van het besturingselement totdat de caret boven aan het besturingselement zichtbaar is. U kunt deze methode gebruiken in een tekstvak met meerdere regels om ervoor te zorgen dat het huidige tekstinvoerpunt zich in het zichtbare gebied van het besturingselement bevindt.