TextBoxBase.ScrollToCaret Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Denetimin içeriğini geçerli şapka işareti konumuna kaydırıyor.

public:
 void ScrollToCaret();

public void ScrollToCaret ();

member this.ScrollToCaret : unit -> unit

Public Sub ScrollToCaret ()

Örnekler

Aşağıdaki kod örneği, giriş işaretiyle gösterilen metin ekleme noktasının ENTER tuşuna basıldıktan sonra ekranda her zaman görünür olmasını sağlamak için numaralandırmanın ve ScrollToCaret yönteminin nasıl kullanılacağını Keys gösterir. Örneği çalıştırmak için, aşağıdaki kodu adlı bir denetimi ve adlı RichTextBox1TextBox1 bir TextBox denetimi içeren bir RichTextBox forma yapıştırın. Bu örnek, olay işleme yönteminin olayla KeyDown ilişkilendirilmiş olmasını gerektirir.

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

Açıklamalar

Bu yöntem, şapka işareti denetimin görünür bölgesi içinde olana kadar denetimin içeriğini kaydırmanızı sağlar. Şapka işareti denetimin görünür bölgesinin altına konumlandırılırsa yöntem, ScrollToCaret denetimin altında şapka işareti görünene kadar denetimin içeriğini kaydıracaktır. Şapka işareti denetimin görünür bölgesinin üzerine konumlandırılırsa, bu yöntem denetimin üst kısmında şapka işareti görünene kadar denetimin içeriğini kaydırıyor. Geçerli metin giriş noktasının denetimin görünür bölgesi içinde olduğundan emin olmak için bu yöntemi çok satırlı bir metin kutusunda kullanabilirsiniz.

Not

Denetimin odağı yoksa veya şapka işareti denetimin görünür bölgesinde zaten konumlandırılmışsa bu yöntemin hiçbir etkisi olmaz.