Share via


LB_SETCARETINDEX mensagem

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.

Parâmetros

wParam

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

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : o parâmetro wParam é limitado a valores de 16 bits. Isso significa que as caixas de listagem não podem conter mais de 32.767 itens. Embora o número de itens seja restrito, o tamanho total em bytes dos itens em uma caixa de listagem é limitado apenas pela memória disponível.

lParam

Se esse valor for FALSE, o item será rolado até ficar totalmente visível; se for TRUE, o item será rolado até que esteja pelo menos parcialmente visível.

Valor retornado

Se ocorrer um erro, o valor retornado será LB_ERR (-1). Caso contrário, LB_OKAY (0) será retornado.

Comentários

Se essa mensagem for enviada para uma caixa de listagem de seleção única que não contenha um item selecionado, o índice de cursor será definido como o item especificado pelo parâmetro wParam . Se a caixa de listagem de seleção única contiver um item selecionado, a caixa de listagem retornará LB_ERR.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclua Windows.h)

Confira também

LB_GETCARETINDEX