CListBox::SelectString

Artigo
02/25/2013

Procura um item da caixa de listagem que coincide com a cadeia de caracteres especificada, e se um item correspondente for localizado, selecione o item.

int SelectString(
   int nStartAfter,
   LPCTSTR lpszItem 
);

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 nStartAfter é – 1, a caixa de listagem inteira é procurado do início.
lpszItem
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 do item selecionado se a pesquisa foi bem-sucedida.Se a pesquisa foi mal sucedido, o valor de retorno é LB_ERR e a seleção atual não é alterada.

Comentários

A caixa de listagem é rolada se necessário, para transferir o item selecionado no modo.

Essa função de membro não pode ser usada com uma caixa de listagem que tem o estilo de LBS_MULTIPLESEL .

Um item é selecionado somente se seus caracteres iniciais (ponto de partida) correspondem aos caracteres na cadeia de caracteres especificada por lpszItem.

Use a função de membro de FindString para localizar uma cadeia de caracteres sem selecione o item.

Exemplo

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

// Select the item that begins with the specified string.
int nIndex = m_myListBox.SelectString(0, lpszmyString);
ASSERT(nIndex != LB_ERR);