ListBox.FindString Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Vyhledá první položku v řetězci ListBox , která začíná zadaným řetězcem.

Přetížení

FindString(String)	Vyhledá první položku v řetězci ListBox , která začíná zadaným řetězcem.
FindString(String, Int32)	Vyhledá první položku v řetězci ListBox , která začíná zadaným řetězcem. Hledání začíná na konkrétním počátečním indexu.

FindString(String)

Vyhledá první položku v řetězci ListBox , která začíná zadaným řetězcem.

public:
 int FindString(System::String ^ s);

public int FindString (string s);

member this.FindString : string -> int

Public Function FindString (s As String) As Integer

Parametry

s

String

Text, který chcete vyhledat.

Návraty

Int32

Nalezený index první položky založený na nule; vrátí, ListBox.NoMatches pokud nebyla nalezena žádná shoda.

Výjimky

ArgumentOutOfRangeException

Hodnota parametru s je menší než -1 nebo větší než nebo rovna počtu položek.

Příklady

Následující příklad kódu ukazuje, jak použít metodu FindString k vyhledání první instance řetězce v ListBox. Pokud nejsou nalezeny žádné položky, které odpovídají vyhledávacímu řetězci FindString , vrátí hodnotu -1 a příklad zobrazí MessageBoxhodnotu . Pokud se najde položka, která odpovídá hledanému textu, použije příklad metodu SetSelected k výběru položky v objektu ListBox.

private:
   void FindMyString( String^ searchString )
   {
      // Ensure we have a proper string to search for.
      if ( searchString != String::Empty )
      {
         // Find the item in the list and store the index to the item.
         int index = listBox1->FindString( searchString );

         // Determine if a valid index is returned. Select the item if it is valid.
         if ( index != -1 )
                  listBox1->SetSelected( index, true );
         else
                  MessageBox::Show( "The search string did not match any items in the ListBox" );
      }
   }

private void FindMyString(string searchString)
{
   // Ensure we have a proper string to search for.
   if (!string.IsNullOrEmpty(searchString))
   {
      // Find the item in the list and store the index to the item.
      int index = listBox1.FindString(searchString);
      // Determine if a valid index is returned. Select the item if it is valid.
      if (index != -1)
         listBox1.SetSelected(index,true);
      else
         MessageBox.Show("The search string did not match any items in the ListBox");
   }
}

Private Sub FindMyString(ByVal searchString As String)
   ' Ensure we have a proper string to search for.
   If searchString <> String.Empty Then
      ' Find the item in the list and store the index to the item.
      Dim index As Integer = listBox1.FindString(searchString)
      ' Determine if a valid index is returned. Select the item if it is valid.
      If index <> -1 Then
         listBox1.SetSelected(index, True)
      Else
         MessageBox.Show("The search string did not match any items in the ListBox")
      End If
   End If
End Sub

Poznámky

Hledání prováděné touto metodou nerozlišuje malá a velká písmena. Hledání hledá slova, která částečně odpovídají zadanému parametru vyhledávacího řetězce, s. Tuto metodu můžete použít k vyhledání první položky, která odpovídá zadanému řetězci. Pak můžete provádět úlohy, jako je odebrání položky obsahující hledaný text pomocí Remove metody nebo změny textu položky. Jakmile najdete zadaný text, pokud chcete vyhledat jiné instance textu v souboru ListBox, můžete použít verzi FindString metody, která poskytuje parametr pro zadání počátečního indexu ListBoxv rámci . Pokud chcete vyhledat přesnou shodu slov místo částečné shody, použijte metodu FindStringExact .

Viz také

• FindStringExact(String)
• Contains(Object)

FindString(String, Int32)

Vyhledá první položku v řetězci ListBox , která začíná zadaným řetězcem. Hledání začíná na konkrétním počátečním indexu.

public:
 int FindString(System::String ^ s, int startIndex);

public int FindString (string s, int startIndex);

member this.FindString : string * int -> int

Public Function FindString (s As String, startIndex As Integer) As Integer

Parametry

s

String

Text, který chcete vyhledat.

startIndex

Int32

Index položky založený na nule před první položkou, která se má prohledávat. Nastavte na záporný jeden (-1) a vyhledejte ho od začátku ovládacího prvku.

Návraty

Int32

Nalezený index první položky založený na nule; vrátí, ListBox.NoMatches pokud nebyla nalezena žádná shoda.

Výjimky

ArgumentOutOfRangeException

Parametr startIndex je menší než nula nebo větší než nebo rovno hodnotě Count vlastnosti ListBox.ObjectCollection třídy.

Příklady

Následující příklad kódu ukazuje, jak použít metodu FindString hledat všechny instance hledaného textu v položkách ListBox. Příklad používá verzi FindString metody, která umožňuje zadat počáteční vyhledávací index, ze kterého se má provádět nepřetržité vyhledávání všech položek v souboru ListBox. Příklad také ukazuje, jak určit, kdy FindString metoda začne hledat z horní části seznamu, jakmile dosáhne dolní části seznamu položek, aby se zabránilo rekurzivnímu vyhledávání. Jakmile jsou položky nalezeny v ListBox, jsou vybrány pomocí SetSelected metody.

private:
   void FindAllOfMyString( String^ searchString )
   {
      // Set the SelectionMode property of the ListBox to select multiple items.
      listBox1->SelectionMode = SelectionMode::MultiExtended;

      // Set our intial index variable to -1.
      int x = -1;

      // If the search string is empty exit.
      if ( searchString->Length != 0 )
      {
         // Loop through and find each item that matches the search string.
         do
         {
            // Retrieve the item based on the previous index found. Starts with -1 which searches start.
            x = listBox1->FindString( searchString, x );

            // If no item is found that matches exit.
            if ( x != -1 )
            {
               // Since the FindString loops infinitely, determine if we found first item again and exit.
               if ( listBox1->SelectedIndices->Count > 0 )
               {
                  if ( x == listBox1->SelectedIndices[ 0 ] )
                                    return;
               }

               // Select the item in the ListBox once it is found.
               listBox1->SetSelected( x, true );
            }
         }
         while ( x != -1 );
      }
   }

private void FindAllOfMyString(string searchString)
{
   // Set the SelectionMode property of the ListBox to select multiple items.
   listBox1.SelectionMode = SelectionMode.MultiExtended;
   
   // Set our intial index variable to -1.
   int x =-1;
   // If the search string is empty exit.
   if (searchString.Length != 0)
   {
      // Loop through and find each item that matches the search string.
      do
      {
         // Retrieve the item based on the previous index found. Starts with -1 which searches start.
         x = listBox1.FindString(searchString, x);
         // If no item is found that matches exit.
         if (x != -1)
         {
            // Since the FindString loops infinitely, determine if we found first item again and exit.
            if (listBox1.SelectedIndices.Count > 0)
            {
               if(x == listBox1.SelectedIndices[0])
                  return;
            }
            // Select the item in the ListBox once it is found.
            listBox1.SetSelected(x,true);
         }
      }while(x != -1);
   }
}

Private Sub FindAllOfMyString(ByVal searchString As String)
   ' Set the SelectionMode property of the ListBox to select multiple items.
   listBox1.SelectionMode = SelectionMode.MultiExtended

   ' Set our intial index variable to -1.
   Dim x As Integer = -1
   ' If the search string is empty exit.
   If searchString.Length <> 0 Then
      ' Loop through and find each item that matches the search string.
      Do
         ' Retrieve the item based on the previous index found. Starts with -1 which searches start.
         x = listBox1.FindString(searchString, x)
         ' If no item is found that matches exit.
         If x <> -1 Then
            ' Since the FindString loops infinitely, determine if we found first item again and exit.
            If ListBox1.SelectedIndices.Count > 0 Then
               If x = ListBox1.SelectedIndices(0) Then
                  Return
               End If
            End If
            ' Select the item in the ListBox once it is found.
            ListBox1.SetSelected(x, True)
         End If
      Loop While x <> -1
   End If
End Sub

Poznámky

Hledání prováděné touto metodou nerozlišuje malá a velká písmena. Hledání hledá slova, která částečně odpovídají zadanému parametru vyhledávacího řetězce, s. Tuto metodu můžete použít k vyhledání první položky, která odpovídá zadanému řetězci v zadaném počátečním indexu v seznamu položek pro ListBox. Pak můžete provádět úlohy, jako je odebrání položky obsahující hledaný text pomocí Remove metody nebo změny textu položky. Tato metoda se obvykle používá po volání pomocí verze této metody, která nezadá počáteční index. Jakmile se v seznamu najde počáteční položka, tato metoda se obvykle používá k vyhledání dalších instancí hledaného textu zadáním pozice indexu v startIndex parametru položky po první nalezené instanci hledaného textu. Pokud chcete vyhledat přesnou shodu slov místo částečné shody, použijte metodu FindStringExact .

Poznámka

Když hledání dosáhne dolní části ListBox, pokračuje hledání z horní části ListBox zpět na položku určenou parametrem startIndex .

Viz také

• FindStringExact(String)
• Contains(Object)