TextBoxBase.ScrollToCaret Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

TextBoxBase.cs

A vezérlő tartalmát az aktuális simító pozícióba görgeti.

public:
 void ScrollToCaret();

public void ScrollToCaret();

member this.ScrollToCaret : unit -> unit

Public Sub ScrollToCaret ()

Példák

Az alábbi példakód bemutatja, hogyan használható az Keys enumerálás és a ScrollToCaret metódus annak biztosítására, hogy a szöveg beszúrási pontja, amelyet a gondnok jelöl, mindig látható legyen a képernyőn az ENTER billentyű lenyomása után. A példa futtatásához illessze be a következő kódot egy olyan űrlapba, amely egy hívott TextBox vezérlőelemet és egy TextBox1RichTextBox hívott vezérlőelemet RichTextBox1tartalmaz. Ez a példa megköveteli, hogy az eseménykezelési módszer hozzá lett rendelve az KeyDown eseményhez.

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

Megjegyzések

Ezzel a módszerrel görgetheti a vezérlő tartalmát, amíg a simító a vezérlő látható régióján belül nem található. Ha a simító a vezérlőelem látható területe alatt van elhelyezve, a ScrollToCaret metódus addig görgeti a vezérlő tartalmát, amíg a simító látható nem lesz a vezérlő alján. Ha a simító a vezérlő látható területe felett van elhelyezve, ez a módszer görgeti a vezérlő tartalmát, amíg a simító látható nem lesz a vezérlő tetején. Ezzel a módszerrel többsoros szövegmezőben biztosíthatja, hogy az aktuális szövegbeviteli pont a vezérlőelem látható régióján belül legyen.

Note

Ennek a módszernek nincs hatása, ha a vezérlő nincs fókuszban, vagy ha a simító már a vezérlőelem látható régiójában van.