ComboBox_SelectString macro (windowsx.h)

Pesquisa uma lista em uma caixa de combinação 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 CB_SELECTSTRING explicitamente.

Sintaxe

int ComboBox_SelectString(
   HWND    hwndCtl,
   int     indexStart,
   LPCTSTR lpszSelect
);

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 lista, ela continua pesquisando da parte superior da lista de volta para o item especificado pelo parâmetro indexStart. Se indexStart for –1, toda a lista será pesquisada desde o início.

lpszSelect

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á CB_ERR e a seleção atual não será alterada.

Observações

Para obter mais informações, consulte CB_SELECTSTRING.

Requisitos