Compartilhar via


LB_SETCARETINDEX message

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.

Parameters

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) : The wParam parameter is limited to 16-bit values. 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

If this value is FALSE, the item is scrolled until it is fully visible; if it is TRUE, the item is scrolled until it is at least partially visible.

Return value

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

Remarks

If this message is sent to a single-selection list box that does not contain a selected item, the caret index is set to the item specified by the wParam parameter. Se a caixa de listagem de seleção única contiver um item selecionado, a caixa de listagem retornará LB_ERR.

Requirements

Requirement Value
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]
Header
Winuser.h (inclua Windows.h)

See also

LB_GETCARETINDEX