TextBoxBase.ScrollToCaret Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Scorre il contenuto del controllo fino alla posizione corrente del punto di inserimento.

public:
 void ScrollToCaret();

public void ScrollToCaret ();

member this.ScrollToCaret : unit -> unit

Public Sub ScrollToCaret ()

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare l'enumerazione Keys e il ScrollToCaret metodo per assicurarsi che il punto di inserimento del testo, rappresentato dal cursore, sia sempre visibile sullo schermo dopo la pressione del tasto INVIO. Per eseguire l'esempio, incollare il codice seguente in un modulo contenente un TextBox controllo denominato TextBox1 e un RichTextBox controllo denominato RichTextBox1. In questo esempio è necessario che il metodo di gestione degli eventi sia stato associato all'evento KeyDown .

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

Commenti

Questo metodo consente di scorrere il contenuto del controllo fino a quando il cursore non si trova all'interno dell'area visibile del controllo. Se il cursore è posizionato sotto l'area visibile del controllo, il ScrollToCaret metodo scorrerà il contenuto del controllo fino a quando il cursore non sarà visibile nella parte inferiore del controllo. Se il cursore è posizionato sopra l'area visibile del controllo, questo metodo scorre il contenuto del controllo fino a quando il cursore non è visibile nella parte superiore del controllo. È possibile utilizzare questo metodo in una casella di testo su più righe per assicurarsi che il punto di ingresso del testo corrente si trovi all'interno dell'area visibile del controllo.

Nota

Questo metodo non ha alcun effetto se il controllo non ha lo stato attivo o se il cursore è già posizionato nell'area visibile del controllo.