CB_SELECTSTRING mensagem
Pesquisa 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 item correspondente for encontrado, ele será selecionado e copiado para o controle de edição.
Parâmetros
-
wParam
-
O índice baseado em zero do item anterior ao primeiro item a ser pesquisado. Quando a pesquisa atinge a parte inferior da lista, ela continua da parte superior da lista de volta para o item especificado pelo parâmetro wParam . Se wParam for -1, toda a lista será pesquisada desde o início.
-
lParam
-
Um ponteiro para a cadeia de caracteres terminada em nulo que contém os caracteres para os quais pesquisar. A pesquisa não diferencia maiúsculas e minúsculas. Portanto, essa cadeia de caracteres pode conter qualquer combinação de letras maiúsculas e minúsculas.
Valor retornado
Se a cadeia de caracteres for encontrada, o valor retornado será o índice do item selecionado. Se a pesquisa não for bem-sucedida, o valor retornado será CB_ERR e a seleção atual não será alterada.
Comentários
Uma cadeia de caracteres será selecionada somente se os caracteres do ponto de partida corresponderem aos caracteres na cadeia de caracteres de prefixo.
Se você criar a caixa de combinação com um estilo desenhado pelo proprietário, mas sem o estilo CBS_HASSTRINGS , o que a mensagem CB_SELECTSTRING fará dependerá se você usar o estilo CBS_SORT . Se o estilo CBS_SORT for usado, o sistema enviará WM_COMPAREITEM mensagens ao proprietário da caixa de combinação para determinar qual item corresponde à cadeia de caracteres especificada. Se você não usar o estilo CBS_SORT , CB_SELECTSTRING tentará corresponder ao valor DWORD com o valor do parâmetro lParam .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|