TextBoxBase.ScrollToCaret Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

TextBoxBase.cs

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, enter tuşuna basıldıktan sonra giriş işaretiyle gösterilen metin ekleme noktasının ekranda her zaman görünür olmasını sağlamak için numaralandırmanın ve Keys yönteminin nasıl kullanılacağını ScrollToCaret gösterir. Örneği çalıştırmak için, aşağıdaki kodu adlı bir denetimi ve adlı TextBoxTextBox1 bir RichTextBox denetimi içeren bir RichTextBox1 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, ScrollToCaret yöntem denetimin alt kısmında görünene kadar denetimin içeriğini kaydıracaktır. Şapka işareti denetimin görünür bölgesinin üzerinde konumlandırılırsa, bu yöntem denetimin içeriğini denetimin üst kısmında görünene kadar kaydırılır. 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.

Note

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.