ComboBox_SelectItemData macro (windowsx.h)

Pesquisa uma lista em uma caixa de combinação em busca de um item que tenha os dados do item especificados. 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_SelectItemData(
   HWND   hwndCtl,
   int    indexStart,
   LPARAM data
);

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.

data

Tipo: LPARAM

Os dados do item a serem encontrados.

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