TextBoxBase.ScrollToCaret Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

TextBoxBase.cs

Posune obsah ovládacího prvku na aktuální pozici kurzoru.

public:
 void ScrollToCaret();

public void ScrollToCaret();

member this.ScrollToCaret : unit -> unit

Public Sub ScrollToCaret ()

Příklady

Následující příklad kódu ukazuje, jak pomocí výčtu Keys a ScrollToCaret metody zajistit, aby kurzor textu reprezentovaný kurzorem byl vždy viditelný na obrazovce po stisknutí klávesy ENTER. Pokud chcete spustit příklad, vložte do formuláře následující kód obsahující volaný TextBoxTextBox1 ovládací prvek a ovládací prvek volaný RichTextBoxRichTextBox1. Tento příklad vyžaduje, aby byla metoda zpracování událostí přidružena k KeyDown události.

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

Poznámky

Tato metoda umožňuje posouvání obsahu ovládacího prvku, dokud kurzor není v viditelné oblasti ovládacího prvku. Pokud je kurzor umístěn pod viditelnou oblastí ovládacího prvku, metoda posune obsah ovládacího prvku, ScrollToCaret dokud kurzor nebude viditelný v dolní části ovládacího prvku. Pokud je kurzor umístěn nad viditelnou oblastí ovládacího prvku, tato metoda posune obsah ovládacího prvku, dokud kurzor není viditelný v horní části ovládacího prvku. Tuto metodu můžete použít ve víceřádkovém textovém poli, abyste zajistili, že aktuální vstupní bod textu je v viditelné oblasti ovládacího prvku.

Note

Tato metoda nemá žádný vliv, pokud ovládací prvek nemá fokus nebo pokud je kurzor již umístěn v viditelné oblasti ovládacího prvku.