ListBox_SetCaretIndex macro (windowsx.h)

Define o retângulo de foco para o item no índice especificado em uma caixa de listagem de seleção múltipla. Se o item não estiver visível, ele será rolado para exibição. Você pode usar essa macro ou enviar a mensagem LB_SETCARETINDEX explicitamente.

Sintaxe

int ListBox_SetCaretIndex(
   HWND hwndCtl,
   int  index
);

Parâmetros

hwndCtl

Tipo: HWND

Um identificador para o controle.

index

Tipo: int

o índice baseado em zero do item da caixa de listagem que deve receber o retângulo de foco.

Valor de retorno

Tipo: int

Se ocorrer um erro, o valor retornado será LB_ERR.

Observações

O conteúdo da caixa de listagem é rolado até que o item esteja totalmente visível.

Para obter mais informações, consulte LB_SETCARETINDEX.

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