TBM_GETTICPOS mensagem

Recupera a posição física atual de uma marca de escala em uma barra de controle.

Parâmetros

wParam

Índice baseado em zero que identifica uma marca de escala. As posições das primeira e última marcas de escala não estão diretamente disponíveis por meio desta mensagem.

lParam

Deve ser zero.

Valor retornado

Retorna a distância, nas coordenadas do cliente, da esquerda ou da parte superior da área do cliente da barra de controle para a marca de escala especificada. O valor retornado é a coordenada x da marca de escala para uma barra de controle horizontal ou a coordenada y para uma barra de controle vertical. Se wParam não for um índice válido, o valor retornado será -1.

Comentários

Como as primeira e última marca de escala não estão disponíveis por meio dessa mensagem, os índices válidos são deslocados de sua posição de escala na barra de faixa. Se a diferença entre TBM_GETRANGEMIN e TBM_GETRANGEMAX for menor que dois, não haverá nenhum índice válido e essa mensagem falhará.

O seguinte ilustra a relação entre os tiques em uma barra de controle, os tiques disponíveis por meio dessa mensagem e seus índices baseados em zero.

0 1 2 3 4 5 6 7 8 9    // Tick positions seen on the trackbar.
  1 2 3 4 5 6 7 8      // Tick positions whose position can be identified.
  0 1 2 3 4 5 6 7      // Index numbers for the identifiable positions.

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