CComboBox::SelectString

Artigo
08/25/2010

Localiza uma seqüência de caracteres em caixa de listagem de uma caixa de combinação e se a seqüência for localizada, seleciona a seqüência de caracteres na caixa de listagem e o copia para o controle de edição.

int SelectString(
   int nStartAfter,
   LPCTSTR lpszString 
);

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. Se – 1, a caixa de listagem inteira é pesquisado desde o início.
lpszString
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 baseado em zero do item selecionado se a cadeia de caracteres foi encontrada.Se a Pesquisar não for bem-sucedida, o valor retornado é CB_ERR e a seleção corrente não é alterado.

Comentários

Uma seqüência de caracteres é selecionada apenas se os caracteres iniciais (a partir do ponto inicial) correspondem aos caracteres na seqüência de caracteres de prefixo.

Observe que o SelectString e FindString membro funções localizar uma seqüência de caracteres, mas o SelectString função de membro também seleciona a seqüência 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);