ListBox_SelectItemData macro (windowsx.h)

Pesquisa uma caixa de listagem 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 LB_SELECTSTRING explicitamente.

Sintaxe

int ListBox_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 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.

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

Observações

Para obter mais informações, consulte LB_SELECTSTRING.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	windowsx.h