TextBoxBase.ScrollToCaret Metod

public:
 void ScrollToCaret();

public void ScrollToCaret();

member this.ScrollToCaret : unit -> unit

Public Sub ScrollToCaret ()

Exempel

Följande kodexempel visar hur du använder Keys uppräkningen och ScrollToCaret metoden för att säkerställa att textinfogningspunkten, som representeras av caret, alltid visas på skärmen när RETUR-tangenten har tryckts på. Om du vill köra exemplet klistrar du in följande kod i ett formulär som innehåller en TextBox kontroll som heter TextBox1 och en RichTextBox kontroll med namnet RichTextBox1. Det här exemplet kräver att händelsehanteringsmetoden har associerats med KeyDown händelsen.

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

Kommentarer

Med den här metoden kan du rulla innehållet i kontrollen tills caret ligger inom kontrollens synliga region. Om caret är placerad under kontrollens synliga region ScrollToCaret bläddrar metoden i innehållet i kontrollen tills caret visas längst ned i kontrollen. Om caret är placerad ovanför kontrollens synliga region rullar den här metoden innehållet i kontrollen tills caret visas överst i kontrollen. Du kan använda den här metoden i en textruta med flera rader för att säkerställa att den aktuella textinmatningspunkten ligger inom kontrollens synliga region.