Compartilhar via


Mensagem TBM_GETPOS

Recupera a posição atual de um controle up-down com precisão de 16 bits.

Parâmetros

wParam

Deve ser zero.

lParam

Deve ser zero.

Valor retornado

Se tiver êxito, o HIWORD será definido como zero e o LOWORD será definido como a posição atual do controle. Se ocorrer um erro, o HIWORD será definido como um valor diferente de zero.

Comentários

Ao processar essa mensagem, o controle up-down atualizará sua posição atual com base na legenda do buddy window. O controle up-down retornará um erro se não houver nenhuma buddy window ou se a legenda especificar um valor inválido ou fora do intervalo. Além disso, um sinalizador de erro é definido no HIWORD do retorno se o controle for criado sem o estilo UDS_SETBUDDYINT, mesmo que ele retorne um valor de posição válido no LOWORD do retorno.

Se os valores de 32 bits tiverem sido habilitados para um controle up-down UDM_SETRANGE32, essa mensagem retornará apenas os 16 bits inferiores da posição. Para recuperar a posição completa de 32 bits, use UDM_GETPOS32.

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
Commctrl.h

Confira também

Referência

UDM_GETRANGE

UDM_GETRANGE32

UDM_SETPOS

UDM_SETRANGE32