Partilhar via


LB_FINDSTRINGEXACT mensagem

Localiza a primeira cadeia de caracteres de caixa de listagem que corresponde exatamente à cadeia de caracteres especificada, exceto que a pesquisa não diferencia maiúsculas de minúsculas.

Parâmetros

wParam

O índice baseado em zero do item antes do primeiro item a ser pesquisado. Quando a pesquisa atinge a parte inferior da caixa de listagem, ela continua pesquisando 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.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : o parâmetro wParam é limitado a valores de 16 bits. Isso significa que as caixas de listagem não podem conter mais de 32.767 itens. Embora o número de itens seja restrito, o tamanho total em bytes dos itens em uma caixa de listagem é limitado apenas pela memória disponível.

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 ou LB_ERR se a pesquisa não foi bem-sucedida.

Comentários

Essa função só terá êxito se a cadeia de caracteres especificada e um item de caixa de listagem tiverem o mesmo comprimento (exceto o nulo no final da cadeia de caracteres especificada) e tiverem exatamente os mesmos caracteres.

Se a caixa de listagem tiver o estilo desenhado pelo proprietário, mas não o estilo de LBS_HASSTRINGS , a ação executada por LB_FINDSTRINGEXACT dependerá se o estilo de LBS_SORT é usado. Se LBS_SORT for usado, o sistema enviará WM_COMPAREITEM mensagens ao proprietário da caixa de listagem para determinar qual item corresponde à cadeia de caracteres especificada. Caso contrário, LB_FINDSTRINGEXACT tenta localizar um item que tenha um valor longo (fornecido como o parâmetro lParam da mensagem LB_ADDSTRING ou LB_INSERTSTRING ) que corresponda ao 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

LB_FINDSTRING