Help Center

CTooltip.HitTestmethod

Tests a point to determine whether it is within the bounding rectangle of the specified tool and, if it is, retrieves information about the tool.

WindowsmethodCTooltip.incdocumented

Syntax

FUNCTION HitTest (BYVAL hTooltip AS HWND, BYVAL lphti AS TTHITTESTINFOW PTR) AS BOOLEAN
FUNCTION HitTest (BYVAL hTooltip AS HWND, BYREF phti AS TTHITTESTINFOW) AS BOOLEAN

Parameters

NameDescription
hTooltipThe handle of the Tooltip control.
lphtiPointer to a TTHITTESTINFO structure. When sending the message, the hwnd member must specify the handle to a tool and the pt member must specify the coordinates of a point. If the return value is TRUE, the ti member (a TOOLINFOW structure) receives information about the tool that occupies the point. The cbSize member of the ti structure must be filled in before sending this message.

Return value

Returns TRUE if the tool occupies the specified point, or FALSE otherwise.

Description

Tests a point to determine whether it is within the bounding rectangle of the specified tool and, if it is, retrieves information about the tool.

Remarks

This message must be sent when the tool has the TTF_TRACK flag set. For more information on this flag, see TOOLINFOW. TTM_HITTEST will fail if TTF_TRACK is not set, regardless if the hit point is in the tools rectangle or not.

Reference

  • Include file CTooltip.inc
  • Defined in AfxNova/CTooltip.inc:490
  • Documented in Windows/WIndows Controls/CTooltip Class.md
  • Topic: CTooltip Class