ComboBox.FindString ComboBox.FindString ComboBox.FindString ComboBox.FindString Method

定義

ComboBox のうち、指定した文字列で始まる最初の項目のインデックスを返します。Returns the index of the first item in the ComboBox that starts with the specified string.

オーバーロード

FindString(String) FindString(String) FindString(String) FindString(String)

ComboBox のうち、指定した文字列で始まる最初の項目のインデックスを返します。Returns the index of the first item in the ComboBox that starts with the specified string.

FindString(String, Int32) FindString(String, Int32) FindString(String, Int32) FindString(String, Int32)

ComboBox 内の指定されたインデックスより後ろの、指定された文字列を含む最初の項目のインデックスを返します。Returns the index of the first item in the ComboBox beyond the specified index that contains the specified string. 検索では、大文字と小文字が区別されません。The search is not case sensitive.

FindString(String) FindString(String) FindString(String) FindString(String)

ComboBox のうち、指定した文字列で始まる最初の項目のインデックスを返します。Returns the index of the first item in the ComboBox that starts with the specified string.

public:
 int FindString(System::String ^ s);
public int FindString (string s);
member this.FindString : string -> int
Public Function FindString (s As String) As Integer

パラメーター

s
String String String String

検索対象の StringThe String to search for.

戻り値

最初に見つかった項目の 0 から始まるインデックス番号。一致する項目が見つからない場合は、-1 を返します。The zero-based index of the first item found; returns -1 if no match is found.

次のコード例は、 FindStringメソッドとSelectedIndexプロパティの使用方法を示しています。The following code example shows the usage of the FindString method and SelectedIndex property. この例は、 ComboBoxクラスの概要の完全なコード例の一部です。The example is part of a complete code example in the ComboBox class overview.

void findButton_Click( Object^ sender, System::EventArgs^ e )
{
   int index = comboBox1->FindString( textBox2->Text );
   comboBox1->SelectedIndex = index;
}
private void findButton_Click(object sender, System.EventArgs e) {
    int index = comboBox1.FindString(textBox2.Text);
    comboBox1.SelectedIndex = index;
}
Private Sub findButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim index As Integer
    index = comboBox1.FindString(textBox2.Text)
    comboBox1.SelectedIndex = index
End Sub

注釈

このメソッドで実行される検索では、大文字と小文字は区別されません。The search performed by this method is not case-sensitive. sパラメーターは、コンボボックスリスト内の項目に関連付けられたテキストと比較する部分文字列です。The s parameter is a substring to compare against the text associated with the items in the combo box list. 検索では、テキストの先頭から部分一致を実行し、指定した部分文字列と一致するリスト内の最初の項目を返します。The search performs a partial match starting from the beginning of the text, and returning the first item in the list that matches the specified substring. その後、 Removeメソッドを使用して検索テキストを含む項目を削除したり、項目のテキストを変更したりするなどのタスクを実行できます。You can then perform tasks, such as removing the item that contains the search text using the Remove method or changing the item's text. 指定したテキストが見つかったら、内ComboBoxのテキストの他のインスタンスを検索するには、の開始インデックスComboBoxを指定するためのFindStringパラメーターを提供するバージョンのメソッドを使用する必要があります。Once you have found the specified text, if you want to search for other instances of the text in the ComboBox, you must use the version of the FindString method that provides a parameter for specifying a starting index within the ComboBox. 部分一致ではなく完全一致する単語の検索を実行する場合は、 FindStringExactメソッドを使用します。If you want to perform a search for an exact word match instead of a partial match, use the FindStringExact method.

FindString(String, Int32) FindString(String, Int32) FindString(String, Int32) FindString(String, Int32)

ComboBox 内の指定されたインデックスより後ろの、指定された文字列を含む最初の項目のインデックスを返します。Returns the index of the first item in the ComboBox beyond the specified index that contains the specified string. 検索では、大文字と小文字が区別されません。The search is not case sensitive.

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

パラメーター

s
String String String String

検索対象の StringThe String to search for.

startIndex
Int32 Int32 Int32 Int32

最初の検索対象項目の前にある項目の 0 から始まるインデックス番号。The zero-based index of the item before the first item to be searched. コントロールの先頭から検索する場合は -1 を設定します。Set to -1 to search from the beginning of the control.

戻り値

最初に見つかった項目のインデックス (0 から始まる)。一致する項目が見つからない場合は -1。s パラメーターに Empty が指定されている場合は 0。The zero-based index of the first item found; returns -1 if no match is found, or 0 if the s parameter specifies Empty.

例外

startIndex が -1 より小さい。The startIndex is less than -1.

または-or- startIndex がコレクション内の最後のインデックスを超える値です。The startIndex is greater than the last index in the collection.

注釈

このメソッドで実行される検索では、大文字と小文字は区別されません。The search performed by this method is not case-sensitive. sパラメーターは、コンボボックスリスト内の項目に関連付けられたテキストと比較する部分文字列です。The s parameter is a substring to compare against the text associated with the items in the combo box list. 検索では、テキストの先頭から部分一致を実行し、指定した部分文字列と一致するリスト内の最初の項目を返します。The search performs a partial match starting from the beginning of the text, returning the first item in the list that matches the specified substring. その後、 Removeメソッドを使用して検索テキストを含む項目を削除したり、項目のテキストを変更したりするなどのタスクを実行できます。You can then perform tasks, such as removing the item that contains the search text using the Remove method or changing the item's text. このメソッドは、通常、開始インデックスを指定しないバージョンのこのメソッドを使用して呼び出しが行われた後に使用されます。This method is typically used after a call has been made using the version of this method that does not specify a starting index. リストに最初の項目が見つかったら、通常、このメソッドを使用して、検索テキストの最初に見つかったインスタンスの後にある項目startIndexのパラメーターでインデックス位置を指定することで、検索テキストのインスタンスをさらに検索します。Once an initial item has been found in the list, this method is typically used to find further instances of the search text by specifying the index position in the startIndex parameter of the item after the first found instance of the search text. 部分一致ではなく完全一致する単語の検索を実行する場合は、 FindStringExactメソッドを使用します。If you want to perform a search for an exact word match instead of a partial match, use the FindStringExact method.

適用対象