RichTextBox.GetLineFromCharIndex(Int32) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

RichTextBox.cs

Načte číslo řádku ze zadané pozice znaku RichTextBox v textu ovládacího prvku.

public:
 override int GetLineFromCharIndex(int index);

public override int GetLineFromCharIndex(int index);

override this.GetLineFromCharIndex : int -> int

Public Overrides Function GetLineFromCharIndex (index As Integer) As Integer

Parametry

index

Int32

Pozice indexu znaků, která se má prohledávat.

Návraty

Int32

Číslo řádku založené na nule, ve kterém se nachází index znaků.

Příklady

Následující příklad kódu ukazuje použití GetLineFromCharIndex metody. Pokud chcete spustit příklad, vložte následující kód do formuláře obsahujícího RichTextBox ovládací prvek s názvem , tlačítko s názvem RichTextBox1Button1 a dvě textová pole s názvem TextBox1 a TextBox2. Když je příklad spuštěný, zadejte hledaný řetězec TextBox2 a kliknutím na tlačítko získejte výsledky hledání.

// This method demonstrates retrieving line numbers that 
// indicate the location of a particular word
// contained in a RichTextBox. The line numbers are zero-based.
void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   // Reset the results box.
   TextBox1->Text = "";
   
   // Get the word to search from from TextBox2.
   String^ searchWord = TextBox2->Text;
   int index = 0;
   
   //Declare an ArrayList to store line numbers.
   System::Collections::ArrayList^ lineList = gcnew System::Collections::ArrayList;
   do
   {
      // Find occurrences of the search word, incrementing  
      // the start index. 
      index = RichTextBox1->Find( searchWord, index + 1, RichTextBoxFinds::MatchCase );
      if ( index != -1 )
      {
         lineList->Add( RichTextBox1->GetLineFromCharIndex( index ) );
      }
   }
   while ( (index != -1) );

   // Iterate through the list and display the line numbers in TextBox1.
   System::Collections::IEnumerator^ myEnumerator = lineList->GetEnumerator();
   if ( lineList->Count <= 0 )
   {
      TextBox1->Text = searchWord + " was not found";
   }
   else
   {
      TextBox1->SelectedText = searchWord + " was found on line(s):";
      while ( myEnumerator->MoveNext() )
      {
         TextBox1->SelectedText = myEnumerator->Current + " ";
      }
   }
}

// This method demonstrates retrieving line numbers that 
// indicate the location of a particular word
// contained in a RichTextBox. The line numbers are zero-based.

private void Button1_Click(System.Object sender, System.EventArgs e)
{

    // Reset the results box.
    TextBox1.Text = "";

    // Get the word to search from from TextBox2.
    string searchWord = TextBox2.Text;

    int index = 0;

    //Declare an ArrayList to store line numbers.
    System.Collections.ArrayList lineList = new System.Collections.ArrayList();
    do
    {
        // Find occurrences of the search word, incrementing  
        // the start index. 
        index = RichTextBox1.Find(searchWord, index+1, RichTextBoxFinds.MatchCase);
        if (index!=-1)

            // Find the word's line number and add the line 
            // number to the arrayList. 
        {
            lineList.Add(RichTextBox1.GetLineFromCharIndex(index));
        }
    }
    while((index!=-1));

    // Iterate through the list and display the line numbers in TextBox1.
    System.Collections.IEnumerator myEnumerator = lineList.GetEnumerator();
    if (lineList.Count<=0)
    {
        TextBox1.Text = searchWord+" was not found";
    }
    else
    {
        TextBox1.SelectedText = searchWord+" was found on line(s):";
        while (myEnumerator.MoveNext())
        {
            TextBox1.SelectedText = myEnumerator.Current+" ";
        }
    }
}

' This method demonstrates retrieving line numbers that 
' indicate the location of a particular word
' contained in a RichTextBox. The line numbers are zero-based.

Private Sub Button1_Click(ByVal sender As System.Object, _ 
    ByVal e As System.EventArgs) Handles Button1.Click

    ' Reset the results box.
    TextBox1.Text = ""

    ' Get the word to search from from TextBox2.
    Dim searchWord As String = TextBox2.Text

    Dim index As Integer = 0

    'Declare an ArrayList to store line numbers.
    Dim lineList As New System.Collections.ArrayList
    Do
        ' Find occurrences of the search word, incrementing  
        ' the start index. 
        index = RichTextBox1.Find(searchWord, index + 1, _
            RichTextBoxFinds.MatchCase)
        If (index <> -1) Then

            ' Find the word's line number and add the line 
            'number to the arrayList. 
            lineList.Add(RichTextBox1.GetLineFromCharIndex(index))
        End If
    Loop While (index <> -1)

    ' Iterate through the list and display the line numbers in TextBox1.
    Dim myEnumerator As System.Collections.IEnumerator = _
        lineList.GetEnumerator()
    If lineList.Count <= 0 Then
        TextBox1.Text = searchWord & " was not found"
    Else
        TextBox1.SelectedText = searchWord & " was found on line(s):"
        While (myEnumerator.MoveNext)
            TextBox1.SelectedText = myEnumerator.Current & " "
        End While
    End If

End Sub

Poznámky

Tato metoda umožňuje určit číslo řádku na základě indexu znaků zadaného index v parametru metody. První řádek textu v ovládacím prvku vrátí hodnotu nula. Metoda GetLineFromCharIndex vrátí fyzické číslo řádku, kde je indexovaný znak umístěn v ovládacím prvku. Pokud se například část prvního logického řádku textu v ovládacím prvku zalomí na další řádek, metoda vrátí hodnotu 1, GetLineFromCharIndex pokud znak na zadaném indexu znaků zalomil na druhý fyzický řádek. Pokud WordWrap je nastavena na false, žádná část řádku zabalí na další a metoda vrátí 0 pro zadaný znak index. Pomocí této metody můžete určit, ve kterém řádku se nachází určitý index znaků. Například po volání Find metody pro hledání textu můžete získat index znaků, do kterého se nacházejí výsledky hledání. Tuto metodu můžete volat s indexem znaků vráceným metodou Find k určení řádku nalezeného slova.

V některých případech nevyvolá výjimku, GetLineFromCharIndex pokud index je parametr neplatnou hodnotou. Například:

• index Pokud je MinValue parametr nebo -1, GetLineFromCharIndex vrátí hodnotu 0.

• index Pokud je parametr délkou textu nebo GetLineFromCharIndexMaxValuevrátí číslo posledního řádku textu, který není nutně stejný jako Lines.Length-1v závislosti na hodnotě WordWrap vlastnosti.

V těchto případech před voláním GetLineFromCharIndexověřte vstup .

Poznámka:

Pokud index znaků zadaný v parametru index přesahuje dostupný počet řádků obsažených v ovládacím prvku, vrátí se poslední číslo řádku.

Viz také

• GetCharIndexFromPosition(Point)
• GetPositionFromCharIndex(Int32)