CListBox::SelectString

Artigo
08/25/2010

Procura um lista - caixa de item que corresponda a seqüência de caracteres especificada, e se a correspondência de um item for encontrado, seleciona o item.

int SelectString(
   int nStartAfter,
   LPCTSTR lpszItem 
);

Parâmetros

nStartAfter
Contém o índice baseado em zero do item antes do primeiro item a ser pesquisada.Quando a Pesquisar chega a parte inferior da caixa de lista, ele continua da parte superior da caixa de listagem para o item especificado por nStartAfter. If nStartAfter é – 1, a caixa de listagem inteira seja pesquisada desde o início.
lpszItem
Aponta para a seqüência de caracteres terminada com nulo que contém o prefixo para procurar.A Pesquisar é o caso independente, portanto, essa seqüência pode conter qualquer combinação de letras maiúsculas e em minúsculas.

Valor de retorno

O índice do item selecionado se a Pesquisar teve êxito.Se a Pesquisar não for bem-sucedida, o valor retornado é LB_ERR e a seleção corrente não é alterado.

Comentários

O lista caixa é rolada, se necessário, para que o item selecionado de modo de exibição.

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

Um item é selecionado somente se os caracteres iniciais (a partir do ponto inicial) correspondem aos caracteres na seqüência de caracteres especificado por lpszItem.

Use o FindString função de membro para localizar uma seqüência de caracteres sem selecionar 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);