CB_FINDSTRING mensagem

Pesquisa a caixa de listagem de uma caixa de combinação para um item que começa com os caracteres em uma cadeia de caracteres especificada.

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 caixa de listagem, ela continua da parte superior da caixa de listagem de volta para o item especificado pelo parâmetro wParam . Se wParam for -1, toda a caixa de listagem 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

O valor retornado é o índice baseado em zero do item correspondente. Se a pesquisa não for bem-sucedida, ela será CB_ERR.

Comentários

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_FINDSTRING fará dependerá se o aplicativo usar o estilo CBS_SORT . Se você usar o estilo CBS_SORT , WM_COMPAREITEM mensagens serão enviadas 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 , a mensagem CB_FINDSTRING procurará um item de lista que corresponda ao 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_FINDSTRINGEXACT

CB_SELECTSTRING

CB_SETCURSEL

WM_COMPAREITEM