RichTextBox.GetCharIndexFromPosition(Point) Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает индекс ближайшего к указанному местоположению символа.

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

Параметры

pt

Point

Местоположение для поиска.

Возвращаемое значение

Int32

Отсчитываемый от нуля индекс символа в указанном местоположении.

Примеры

В следующем примере кода показано, как использовать GetCharIndexFromPosition метод с методом Find для поиска определенной строки в элементе управления и отображения символьного RichTextBox индекса, в котором находится найденная строка в элементе RichTextBox управления . В примере выполняется поиск слова "коричневый" в содержимом элемента управления и возвращается позиция индекса символа, в которой найдена строка поиска. Для этого примера требуется форма, содержащая RichTextBox элемент управления с именем richTextBox1 , который содержит текст. Кроме того, требуется, чтобы код в примере был подключен к событию MouseDownRichTextBoxобъекта .

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

Комментарии

Этот метод возвращает символьный индекс, ближайший к позиции, указанной в параметре pt . Символьный индекс — это отсчитываемый от нуля индекс текста в элементе управления, включая пробелы. С помощью этого метода можно определить, где в тексте пользователь навести указатель мыши, передав координаты мыши этому методу. Это может быть полезно, если вы хотите выполнять задачи, когда пользователь наведите указатель мыши на слово в тексте элемента управления.

См. также раздел

• GetLineFromCharIndex(Int32)
• GetPositionFromCharIndex(Int32)