Compartilhar via


CB_FINDSTRINGEXACT mensagem

Localiza a primeira cadeia de caracteres de caixa de listagem em uma caixa de combinação que corresponde à cadeia de caracteres especificada no parâmetro lParam .

Parâmetros

wParam

O índice baseado em zero do item que precede o 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 para a qual 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

Essa função só terá êxito se a cadeia de caracteres especificada e um item de caixa de combinação tiverem o mesmo comprimento (exceto o caractere nulo de terminação) e os mesmos caracteres.

Se você criar a caixa de combinação com um estilo desenhado pelo proprietário, mas sem o estilo CBS_HASSTRINGS , a funcionalidade de CB_FINDSTRINGEXACT mensagem 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_FINDSTRINGEXACT 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_FINDSTRING

CB_SELECTSTRING

WM_COMPAREITEM