Compartilhar via


CComboBox::SelectString

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);

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe de CComboBox

Gráfico de hierarquia

CComboBox::FindString

CB_SELECTSTRING