RichTextBox.GetCharIndexFromPosition(Point) Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mengambil indeks karakter terdekat dengan lokasi yang ditentukan.

public:
 override int GetCharIndexFromPosition(System::Drawing::Point pt);

public override int GetCharIndexFromPosition (System.Drawing.Point pt);

override this.GetCharIndexFromPosition : System.Drawing.Point -> int

Public Overrides Function GetCharIndexFromPosition (pt As Point) As Integer

Parameter

pt

Point

Lokasi untuk dicari.

Mengembalikan

Int32

Indeks karakter berbasis nol di lokasi yang ditentukan.

Contoh

Contoh kode berikut menunjukkan cara menggunakan GetCharIndexFromPosition metode dengan Find metode untuk mencari string tertentu dalam RichTextBox kontrol dan menampilkan indeks karakter tempat string yang ditemukan berada di dalam RichTextBox kontrol. Contoh mencari kata "coklat" dalam konten kontrol dan mengembalikan posisi indeks karakter tempat string pencarian ditemukan. Contoh ini mengharuskan Anda memiliki formulir yang berisi RichTextBox kontrol bernama richTextBox1 yang berisi teks. Ini juga mengharuskan kode dalam contoh terhubung ke MouseDown peristiwa RichTextBox.

private:
   void richTextBox1_MouseDown( Object^ /*sender*/, System::Windows::Forms::MouseEventArgs^ e )
   {
      // Declare the string to search for in the control.
      String^ searchString = "brown";

      // Determine whether the user clicks the left mouse button and whether it is a double click.
      if ( e->Clicks == 1 && e->Button == ::MouseButtons::Left )
      {
         // Obtain the character index where the user clicks on the control.
         int positionToSearch = richTextBox1->GetCharIndexFromPosition( Point(e->X,e->Y) );

         // Search for the search string text within the control from the point the user clicked.
         int textLocation = richTextBox1->Find( searchString, positionToSearch, RichTextBoxFinds::None );

         // If the search string is found (value greater than -1), display the index the string was found at.
         if ( textLocation >= 0 )
            MessageBox::Show( String::Format( "The search string was found at character index {0}.", textLocation ) ); // Display a message box alerting the user that the text was not found.
         else
            MessageBox::Show( "The search string was not found within the text of the control." );
      }
   }

private void richTextBox1_MouseDown(object sender, System.Windows.Forms.MouseEventArgs e)
{
    // Declare the string to search for in the control.
    string searchString = "brown";

    // Determine whether the user clicks the left mouse button and whether it is a double click.
    if (e.Clicks == 1 && e.Button == MouseButtons.Left)
    {
        // Obtain the character index where the user clicks on the control.
        int positionToSearch = richTextBox1.GetCharIndexFromPosition(new Point(e.X, e.Y));
        // Search for the search string text within the control from the point the user clicked.
        int textLocation = richTextBox1.Find(searchString, positionToSearch, RichTextBoxFinds.None);

        // If the search string is found (value greater than -1), display the index the string was found at.
        if (textLocation >= 0)
            MessageBox.Show("The search string was found at character index " + textLocation.ToString() + ".");
        else
            // Display a message box alerting the user that the text was not found.
            MessageBox.Show("The search string was not found within the text of the control.");
    }
}

Private Sub richTextBox1_MouseDown(ByVal sender As Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles richTextBox1.MouseDown
    ' Declare the string to search for in the control.
    Dim searchString As String = "brown"

    ' Determine whether the user clicks the left mouse button and whether it is a double click.
    If e.Clicks = 1 And e.Button = MouseButtons.Left Then
        ' Obtain the character index where the user clicks on the control.
        Dim positionToSearch As Integer = richTextBox1.GetCharIndexFromPosition(New Point(e.X, e.Y))
        ' Search for the search string text within the control from the point the user clicked.
        Dim textLocation As Integer = richTextBox1.Find(searchString, positionToSearch, RichTextBoxFinds.None)

        ' If the search string is found (value greater than -1), display the index the string was found at.
        If textLocation >= 0 Then
            MessageBox.Show(("The search string was found at character index " + textLocation.ToString() + "."))
            ' Display a message box alerting the user that the text was not found.
        Else
            MessageBox.Show("The search string was not found within the text of the control.")
        End If
    End If
End Sub

Keterangan

Metode ini mengembalikan indeks karakter yang paling dekat dengan posisi yang ditentukan dalam pt parameter . Indeks karakter adalah indeks teks berbasis nol dalam kontrol, termasuk spasi. Anda dapat menggunakan metode ini untuk menentukan di mana dalam teks pengguna memiliki mouse di atas dengan meneruskan koordinat mouse ke metode ini. Ini dapat berguna jika Anda ingin melakukan tugas ketika pengguna mengarahkan penunjuk mouse ke kata dalam teks kontrol.

Lihat juga

• GetLineFromCharIndex(Int32)
• GetPositionFromCharIndex(Int32)