ComboBox.FindString Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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
- 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.