TBM_GETTICPOS Nachricht

Ruft die aktuelle physische Position eines Häkchens in einer Trackleiste ab.

Parameter

wParam

Nullbasierter Index, der ein Häkchen identifiziert. Die Positionen der ersten und letzten Häkchen sind nicht direkt über diese Nachricht verfügbar.

lParam

Muss Null sein.

Rückgabewert

Gibt den Abstand in Clientkoordinaten vom linken oder oberen Rand des Clientbereichs der Trackleiste zum angegebenen Häkchen zurück. Der Rückgabewert ist die x-Koordinate des Häkchens für eine horizontale Trackleiste oder die y-Koordinate für eine vertikale Spurleiste. Wenn wParam kein gültiger Index ist, ist der Rückgabewert -1.

Bemerkungen

Da die ersten und letzten Häkchen über diese Nachricht nicht verfügbar sind, werden gültige Indizes von ihrer Tickposition auf der Trackleiste versetzt. Wenn der Unterschied zwischen TBM_GETRANGEMIN und TBM_GETRANGEMAX kleiner als zwei ist, ist kein gültiger Index vorhanden, und diese Meldung schlägt fehl.

Im Folgenden wird die Beziehung zwischen den Ticks auf einer Trackleiste, den durch diese Nachricht verfügbaren Ticks und ihren nullbasierten Indizes veranschaulicht.

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.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h