Determines where a point lies in a toolbar control.

Syntax

To send this message, call the SendMessage function as follows.

lResult = SendMessage(    // returns LRESULT in lResult
   hWndControl,           // (HWND) handle to destination control
   TB_HITTEST,            // (UINT) message ID
   wParam,                // = 0; not used, must be zero 
   lParam                 // = (LPARAM)(LPPOINT) pptHitTest;
);

Parameters

wParam

Must be zero.

pptHitTest

Pointer to a POINT structure that contains the x-coordinate of the hit test in the x member and the y-coordinate of the hit test in the y member. The coordinates are relative to the toolbar's client area.

Return Value

Returns an integer value. If the return value is zero or a positive value, it is the zero-based index of the nonseparator item in which the point lies. If the return value is negative, the point does not lie within a button. The absolute value of the return value is the index of a separator item or the nearest nonseparator item.

Message Information

Minimum DLL Version	comctl32.dll version 4.00 or later
Header	commctrl.h
Minimum operating systems	Windows NT 4.0, Windows 95