Compartilhar via


LB_SELECTSTRING mensagem

Pesquisa uma caixa de listagem para um item que começa com os caracteres em uma cadeia de caracteres especificada. Se um item correspondente for encontrado, o item será selecionado.

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 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 que contém o prefixo para o 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

Se a pesquisa for bem-sucedida, o valor retornado será o índice do item selecionado. Se a pesquisa não for bem-sucedida, o valor retornado será LB_ERR e a seleção atual não será alterada.

Comentários

A caixa de listagem é rolada, se necessário, para colocar o item selecionado em exibição.

Não use essa mensagem com uma caixa de listagem que tenha o LBS_MULTIPLESEL ou os estilos de LBS_EXTENDEDSEL .

Um item será selecionado somente se seus caracteres iniciais do ponto de partida corresponderem aos caracteres na cadeia de caracteres especificada pelo parâmetro lParam .

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_SELECTSTRING 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_SELECTSTRING tenta localizar um item que tenha um valor longo (fornecido como o parâmetro lParam do LB_ADDSTRING ou LB_INSERTSTRING mensagem) 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

Referência

LB_ADDSTRING

LB_FINDSTRING

LB_INSERTSTRING