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 |
|
Confira também
-
Referência