TTM_HITTEST Nachricht

Testet einen Punkt, um zu ermitteln, ob er sich innerhalb des begrenzungsenden Rechtecks des angegebenen Tools befindet, und ruft, wenn dies der Grund ist, Informationen zum Tool ab.

Parameter

wParam

Muss Null sein.

lParam

Zeiger auf eine TTHITTESTINFO-Struktur . Beim Senden der Nachricht muss das hwnd-Element das Handle für ein Tool angeben, und das pt-Element muss die Koordinaten eines Punkts angeben. Wenn der Rückgabewert TRUE ist, empfängt das ti-Element (eine TOOLINFO-Struktur ) Informationen über das Tool, das den Punkt einnimmt. Das cbSize-Element der ti-Struktur muss vor dem Senden dieser Nachricht ausgefüllt werden.

Rückgabewert

Gibt TRUE zurück, wenn das Tool den angegebenen Punkt belegt, oder andernfalls FALSE .

Bemerkungen

Diese Nachricht muss gesendet werden, wenn das TTF_TRACK-Flag für das Tool festgelegt ist. Weitere Informationen zu diesem Flag finden Sie unter TOOLINFO. TTM_HITTEST schlägt fehl, wenn TTF_TRACK nicht festgelegt ist, unabhängig davon, ob sich der Trefferpunkt im Werkzeugrechteck befindet oder nicht.

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
Unicode- und ANSI-Name
TTM_HITTESTW (Unicode) und TTM_HITTESTA (ANSI)