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;
}