CB_FINDSTRING

Um aplicativo envia uma mensagem CB_FINDSTRING para procurar a caixa de listagem de uma caixa de combinação para um item que começa com os caracteres em uma Cadeia de caracteres especificada.

CB_FINDSTRING wParam = indexStart (WPARAM);        / / item antes de início da pesquisa lParam = lpszFind (LPARAM) (LPCSTR) / / endereço de Cadeia de caracteres de prefixo 

 

Parâmetros

indexStart
Valor de wParam. Especifica o índice baseado em zero do item antes do primeiro item a ser pesquisado. Quando a pesquisa chega a inferior da caixa de listagem, ele continua da parte superior da caixa de listagem voltar para o item especificado pelo indexStart parâmetro. Se indexStart é – 1, a caixa de lista inteira é pesquisada desde o início.
lpszFind
Valor de lParam. Ponteiro para o seqüência de caracteres null-terminated que contém o prefixo para pesquisar. A pesquisa não diferencia maiúsculas de minúsculas, portanto, este seqüência de caracteres pode conter qualquer combinação de letras maiúsculas e minúsculas.

Retornar valores

O valor de retorno é o índice com base zero do item correspondente. Caso a pesquisa seja bem-sucedida, é CB_ERR.

Observações

Se você criar a caixa de combinação com um estilo owner-drawn mas sem o estilo CBS_HASSTRINGS, o que a mensagem CB_FINDSTRING faz depende se seu aplicativo usa o estilo CBS_SORT. Se você usar o estilo CBS_SORT, WM_COMPAREITEM mensagens são enviadas para o proprietário da caixa de combinação para determinar qual item corresponde a seqüência especificada. Se você não usar o estilo CBS_SORT, a mensagem CB_FINDSTRING procura por um item de lista que corresponde ao valor do parâmetro lpszFind.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.

Ver também

Visão geral de caixas de combinação, as mensagens de caixa de combinação, CB_FINDSTRINGEXACT, CB_SELECTSTRING, CB_SETCURSEL, WM_COMPAREITEM

Index