Compartilhar via


ListBox_SetTopIndex macro (windowsx.h)

Garante que o item especificado em uma caixa de listagem esteja visível. Você pode usar essa macro ou enviar a mensagem LB_SETTOPINDEX explicitamente.

Sintaxe

int ListBox_SetTopIndex(
   HWND hwndCtl,
   int  indexTop
);

Parâmetros

hwndCtl

Tipo: HWND

Um identificador para o controle.

indexTop

Tipo: int

O índice baseado em zero do item a ser colocado na parte superior da parte visível da lista.

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 para que o item especificado apareça na parte superior da caixa de listagem ou o intervalo de rolagem máximo tenha sido atingido.

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