RichTextBox.GetCharIndexFromPosition(Point) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Recupera el índice del carácter más cercano a la ubicación especificada.

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

Parámetros

pt

Point

Ubicación donde se va a buscar.

Devoluciones

Int32

Índice de carácter de base cero de la ubicación especificada.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el GetCharIndexFromPosition método con el Find método para buscar una cadena específica dentro de un RichTextBox control y mostrar el índice de caracteres donde se encuentra la cadena encontrada dentro del RichTextBox control. En el ejemplo se busca la palabra "marrón" dentro del contenido del control y se devuelve la posición del índice de caracteres donde se encuentra la cadena de búsqueda. Este ejemplo requiere que tenga un formulario que contenga un RichTextBox control denominado richTextBox1 que contenga texto. También requiere que el código del ejemplo esté conectado al MouseDown evento de 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

Comentarios

Este método devuelve el índice de caracteres más cercano a la posición especificada en el pt parámetro . El índice de caracteres es un índice de texto basado en cero en el control, incluidos los espacios. Puede usar este método para determinar dónde en el texto el usuario tiene el mouse sobre pasando las coordenadas del mouse a este método. Esto puede ser útil si desea realizar tareas cuando el usuario descansa el puntero del mouse sobre una palabra en el texto del control.

Consulte también

• GetLineFromCharIndex(Int32)
• GetPositionFromCharIndex(Int32)