CB_SELECTSTRING

Um aplicativo envia uma mensagem CB_SELECTSTRING para pesquisar a lista de uma caixa de combinação para um item que começa com os caracteres em uma Cadeia de caracteres especificada. Se um compatível item for encontrado, ele é selecionado e copiado para o controle editar.

CB_SELECTSTRING wParam = indexStart (WPARAM);          / / item antes da primeira seleção lParam = lpszSelect (LPARAM) (LPCSTR); / / endereço da Cadeia de caracteres de prefixo 

 

Parâmetros

indexStart

Valor de wParam. Especifica o índice baseado em zero do item antes do primeiro item a ser pesquisado. Quando a pesquisa chega a inferior da lista, ele continua da parte superior da lista voltar para o item especificado pelo indexStart parâmetro. Se indexStart é – 1, a lista inteira é pesquisada desde o início.

lpszSelect

Valor de lParam. Ponteiro para o seqüência de caracteres null-terminated que contém o prefixo para pesquisar. A pesquisa não diferencia maiúsculas de minúsculas, portanto, este seqüência de caracteres pode conter qualquer combinação de letras maiúsculas e minúsculas.

Retornar valores

Se a Cadeia de caracteres for encontrada, o valor de retorno é o índice do item selecionado. Se Pesquisarrr não tiver êxito, o valor de retorno é CB_ERR e a seleção atual não é alterada.

Observações

Uma Cadeia de caracteres é selecionada apenas se os caracteres de ponto de partida correspondem os caracteres na cadeia de caracteres de prefixo.

Se você criar a caixa de combinação com um estilo owner-drawn mas sem o estilo CBS_HASSTRINGS, o que a mensagem CB_SELECTSTRING faz depende de se você usar o estilo CBS_SORT. Se o estilo CBS_SORT é usado, o sistema envia WM_COMPAREITEM mensagens para o proprietário da caixa de combinação para determinar qual item corresponde a seqüência especificada. Se você não usar o estilo CBS_SORT, CB_SELECTSTRING tenta coincidir com o valor DWORD com o valor do parâmetro lpszSelect.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.

Ver também

Visão geral de caixas de combinação, as mensagens de caixa de combinação, CB_FINDSTRING, CB_FINDSTRINGEXACT, CB_SETCURSEL, WM_COMPAREITEM

Index