ListBox_SelectString macro (windowsx.h)

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. Você pode usar essa macro ou enviar a mensagem LB_SELECTSTRING explicitamente.

Sintaxe

int ListBox_SelectString(
   HWND    hwndCtl,
   int     indexStart,
   LPCTSTR lpszFind
);

Parâmetros

hwndCtl

Tipo: HWND

Um identificador para o controle.

indexStart

Tipo: int

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 indexStart. Se indexStart for –1, a caixa de listagem inteira será pesquisada desde o início.

lpszFind

Tipo: LPCTSTR

A cadeia de caracteres a ser encontrada.

Valor de retorno

Tipo: int

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.

Observações

Para obter mais informações, consulte LB_SELECTSTRING.

Requisitos