L_ILM_HITTEST

Send this message to query the ImageList Control for the index of the item at the specified location.

Parameter	Description
wParam	Ignored, use 0.
lParam	Pointer to a POINT structure containing the location to query.

Returns

>=0	The index of the item at the specified location
< 0	An error occurred, refer to Return Codes.

Comments

This message will return the 0 based index of the item at the specified location, if one exists.

The location is in MM_TEXT mapping mode (pixels), and is relative to the client area of the control's window.

The associated macro is:

L_ImgListHitTest(hWnd, pPoint)

For a complete list of available macros, refer to the Ltlst.h file.

See Also

Elements:	L_ILM_GETITEM, L_ILM_GETITEMCOUNT, L_ILM_SETITEM
Topics:	Using the ImageList Control
	Image List Control Messages

Example

 L_INT ILM_HITTESTExample(HWND hCtrl)
{
   if(IsWindow(hCtrl))
   {
      LRESULT lRet;
      L_TCHAR szText[200];
      POINT pt;

      /* check a location for an item */
      pt.x = 80;
      pt.y = 100;
      lRet = SendMessage(hCtrl, L_ILM_HITTEST, 0, (LPARAM)&pt);
      if(lRet >= 0)
      {
         wsprintf(szText, TEXT("Item: %ld"), lRet);
         MessageBox(hCtrl, szText, TEXT("HitTest"), MB_OK);
      }
      else
         MessageBox(hCtrl, TEXT("None"), TEXT("HitTest"), MB_OK);
      return SUCCESS;
   }
   else
      return ERROR_INVALID_PARAMETER;
}