Compartilhar via


LB_FINDSTRING mensagem

Localiza a primeira cadeia de caracteres em uma caixa de listagem que começa com a cadeia de caracteres especificada.

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 na 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 que contém a cadeia de caracteres para a qual pesquisar. A pesquisa é independente de 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 do item correspondente ou LB_ERR se a pesquisa não foi bem-sucedida.

Comentários

Se a caixa de listagem tiver o estilo desenhado pelo proprietário, mas não o estilo LBS_HASSTRINGS , a ação executada pelo LB_FINDSTRING dependerá se o estilo de LBS_SORT for usado. Se LBS_SORT for usado, o sistema enviará WM_COMPAREITEM mensagens para o proprietário da caixa de listagem para determinar qual item corresponde à cadeia de caracteres especificada. Caso contrário, LB_FINDSTRING 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_FINDSTRINGEXACT