ListBox_SelectString macro (windowsx.h)

Artigo
10/24/2024

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

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

Compartilhar via