ComboBox.FindString Método

Definição

Devolve o índice do primeiro item do ComboBox que começa com a cadeia especificada.

Sobrecargas

Name Description
FindString(String)

Devolve o índice do primeiro item do ComboBox que começa com a cadeia especificada.

FindString(String, Int32)

Devolve o índice do primeiro item do ComboBox índice para além do especificado que contém a cadeia especificada. A busca não distingue minúsculas e minúsculas.

FindString(String)

Devolve o índice do primeiro item do ComboBox que começa com a cadeia especificada.

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

Parâmetros

s
String

O String que procurar.

Devoluções

O índice em base zero do primeiro item encontrado; Retorna -1 se não for encontrada correspondência.

Exemplos

O exemplo de código seguinte mostra a utilização do método e SelectedIndex da FindString propriedade. O exemplo faz parte de um exemplo completo de código na ComboBox visão geral da classe.

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

Observações

A pesquisa realizada por este método não é sensível a maiúsculas minúsculas. O s parâmetro é uma subcadeia para comparar com o texto associado aos itens na lista de caixas combinadas. A pesquisa realiza uma correspondência parcial a partir do início do texto e devolve o primeiro item da lista que corresponde à substring especificada. Pode então realizar tarefas, como remover o item que contém o texto da pesquisa usando o Remove método ou alterar o texto do item. Depois de encontrar o texto especificado, se quiser procurar outras instâncias do texto no ComboBox, deve usar a versão do FindString método que fornece um parâmetro para especificar um índice inicial dentro do ComboBox. Se quiser fazer uma pesquisa por uma correspondência exata de palavras em vez de uma correspondência parcial, use o FindStringExact método.

Aplica-se a

FindString(String, Int32)

Devolve o índice do primeiro item do ComboBox índice para além do especificado que contém a cadeia especificada. A busca não distingue minúsculas e minúsculas.

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

Parâmetros

s
String

O String que procurar.

startIndex
Int32

O índice base zero do item antes do primeiro item a ser pesquisado. Definir para -1 para pesquisar desde o início do controlo.

Devoluções

O índice em base zero do primeiro item encontrado; devolve -1 se não for encontrada correspondência, ou 0 se o s parâmetro especificar Empty.

Exceções

O startIndex é inferior a -1.

-ou-

O startIndex é maior do que o último índice da coleção.

Observações

A pesquisa realizada por este método não é sensível a maiúsculas minúsculas. O s parâmetro é uma subcadeia para comparar com o texto associado aos itens na lista de caixas combinadas. A pesquisa realiza uma correspondência parcial a partir do início do texto, retornando o primeiro item da lista que corresponde à substring especificada. Pode então realizar tarefas, como remover o item que contém o texto da pesquisa usando o Remove método ou alterar o texto do item. Este método é normalmente usado após uma chamada ter sido feita usando a versão deste método que não especifica um índice inicial. Uma vez encontrado um item inicial na lista, este método é normalmente usado para encontrar mais instâncias do texto de pesquisa, especificando a posição do índice no startIndex parâmetro do item após a primeira instância encontrada do texto de pesquisa. Se quiser fazer uma pesquisa por uma correspondência exata de palavras em vez de uma correspondência parcial, use o FindStringExact método.

Aplica-se a