TextBoxBase.ScrollToCaret Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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 použít Keys výčet a metodu ScrollToCaret k zajištění, že textový kurzor, reprezentovaný stříškou, je vždy viditelný na obrazovce po stisknutí klávesy ENTER. Pokud chcete spustit příklad, vložte následující kód do formuláře obsahujícího TextBox ovládací prvek s názvem TextBox1 a RichTextBox ovládací prvek s názvem RichTextBox1. Tento příklad vyžaduje, aby byla k události přidružena metoda zpracování událostí 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

Poznámky

Tato metoda umožňuje posouvání obsahu ovládacího prvku, dokud kurzor nebude ve viditelné oblasti ovládacího prvku. Pokud je kurzor umístěn pod viditelnou oblastí ovládacího prvku, ScrollToCaret metoda posune obsah ovládacího prvku, dokud nebude kurzor 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 není kurzor 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 se aktuální textový vstupní bod nachází ve viditelné oblasti ovládacího prvku.

Poznámka

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