TBM_GETTICPOS message

Récupère la position physique actuelle d’une coche dans une barre de suivi.

Paramètres

wParam

Index de base zéro identifiant une coche. Les positions de la première et de la dernière coche ne sont pas directement disponibles via ce message.

lParam

Doit être zéro.

Valeur retournée

Retourne la distance, dans les coordonnées du client, entre la gauche ou le haut de la zone cliente de la barre de suivi jusqu’à la coche spécifiée. La valeur de retour est la coordonnée x de la coche d’une barre de suivi horizontale ou la coordonnée y pour une barre de suivi verticale. Si wParam n’est pas un index valide, la valeur de retour est -1.

Notes

Étant donné que la première et la dernière coche ne sont pas disponibles via ce message, les index valides sont décalés par rapport à leur position de coche sur la barre de suivi. Si la différence entre TBM_GETRANGEMIN et TBM_GETRANGEMAX est inférieure à deux, il n’y a pas d’index valide et ce message échoue.

L’exemple suivant illustre la relation entre les graduations d’une barre de suivi, les graduations disponibles via ce message et leurs index de base zéro.

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.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Commctrl.h