L_ILM_GETITEMOPTIONS

Send this message to get the ImageList Control's item display options.

Parameter	Description
wParam	Ignored, use 0.
lParam	Pointer to LILITEMOPTIONS structure to be filled with current display options.

Returns

SUCCESS	Function was successful
< 0	An error occurred. Refer to Return Codes.

Comments

The structure pointed to by lParam will be updated with the ImageList Control's current display options.

You must set the uStructSize member of the LILITEMOPTIONS structure before using this message.

The default item display options are:

uVerticalSpacing	5
uHorizontalSpacing	5
uWidth	115
uHeight	115
crBackground	GetSysColor(COLOR_BTNFACE)
bDisplayItemText	TRUE
crForeground	RGB(0,0,0)
hFont	NULL (Times New Roman, 8 point)

The associated macro is:

L_ImgListGetItemOptions(hWnd, pItemOptions)

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

See Also

Elements:	L_ILM_SETITEMOPTIONS, L_ILM_GETSELOPTIONS, L_ILM_SETITEMOPTIONS
Topics:	Using the ImageList Control
	Image List Control Messages

Example

L_VOID TestFunc2(HWND hWnd)
{
   LILITEMOPTION Opt; /* item options structure */
   LRESULT lRet;

   /* get current item options */
   Opt.lStructSize = sizeof(LILITEMOPTION);
   lRet = SendMessage(hWnd, L_ILM_GETITEMOPTIONS, 0, (LPARAM)&Opt);

   /* now, set some new options */
   Opt.uVerticalSpacing   = 10;
   Opt.uHorizontalSpacing = 10;
   if(Opt.uWidth < 100)
      Opt.uWidth=100;
   if(Opt.uHeight < 100)
      Opt.uHeight=100;
   Opt.crBackground       = RGB(100,100,100);
   Opt.bDisplayItemText   = FALSE;
   lRet = SendMessage(hWnd, L_ILM_SETITEMOPTIONS, 0, (LPARAM)&Opt);

   /* update the control */
   RedrawWindow(hWnd, NULL, NULL, RDW_INVALIDATE | RDW_UPDATENOW | RDW_ERASE);
}