Compartilhar via

CB_SELECTSTRING mensagem

  • Artigo

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
Winuser.h (inclua Windows.h)

Confira também

Referência

CB_FINDSTRING

CB_FINDSTRINGEXACT

CB_SETCURSEL

WM_COMPAREITEM