CComboBox::SelectString

Artigo
06/10/2015

Procura por uma cadeia de caracteres na caixa de listagem de uma caixa de combinação, e se a cadeia de caracteres for encontrada, selecione a cadeia de caracteres na caixa de listagem e o copie ao controle de edição.

int SelectString( 
   int nStartAfter, 
   LPCTSTR lpszString  
);

Parâmetros

nStartAfter
Contém o índice com base zero de item antes do primeiro item a ser pesquisada. Quando a pesquisa chegar a parte inferior da caixa de listagem, continua a parte superior da lista de volta para o item especificado por nStartAfter. Se – 1, a caixa de listagem completa será pesquisada do início.
lpszString
Pontos a cadeia de caracteres NULL- finalizada por que contém o prefixo para pesquisar. A pesquisa é não diferenciando maiúsculas e minúsculas, portanto essa cadeia de caracteres pode conter qualquer combinação de e maiúsculas de minúsculas.

Valor de retorno

O índice com base zero do item selecionado se a cadeia de caracteres foi encontrada. Se a pesquisa foi mal sucedido, o valor de retorno é CB_ERR e a seleção atual não é alterada.

Comentários

Uma cadeia de caracteres está selecionada somente se seus caracteres iniciais (ponto de partida) correspondem aos caracteres na cadeia de caracteres de prefixo.

Observe que as funções de membro de SelectString ambas e de FindString encontrar uma cadeia de caracteres, mas a função de membro de SelectString também seleciona a cadeia de caracteres.

Exemplo

// The string to match.
LPCTSTR lpszSelect = _T("item");

// Select the item that begins with the specified string. 
int nSel = m_pComboBox->SelectString(0, lpszSelect);
ASSERT(nSel != CB_ERR);