L_ILM_SORTEXT

Show in webframe

Send this message to sort the items in the ImageList Control based on their text or Extended Text attributes referenced in the pTextExt member of the LILITEM structure.

Parameter	Description
wParam	Ignored, use 0.
lParam	Pointer to the LILSORTOPTIONS structure that contains the sorting options to be used.

Returns

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

Comments

The ImageList Control items will be sorted according to the options in the structure pointed to by lParam.

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

The associated macro is:

L_ImgListSortExt(hWnd, pSortOptions)

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

See Also

Elements:	L_ILM_SORT, L_ILM_GETITEMCOUNT, L_ILM_CLEAR
Topics:	Using the ImageList Control
	Image List Control Messages

Example

L_INT ILM_SORTEXTExample(HWND hCtrl)
{
   if(IsWindow(hCtrl))
   {
      LILSORTOPTIONS SortOptions;

      ZeroMemory(&SortOptions, sizeof(LILSORTOPTIONS));
      SortOptions.uStructSize = sizeof(LILSORTOPTIONS);
      SortOptions.bAscending = TRUE; 
      SortOptions.bCaseSensitive = TRUE; 
      SortOptions.bUseExtText = FALSE; 

      /* sort items in Ascending, case Sensitive, and using Text string */
      L_INT nRet = (L_INT)SendMessage(hCtrl, L_ILM_SORTEXT, (WPARAM)0, (LPARAM)(&SortOptions));
      /* update the control */
      RedrawWindow(hCtrl, NULL, NULL, RDW_INVALIDATE | RDW_UPDATENOW | RDW_ERASE);

      return nRet;
   }
   else
      return ERROR_INVALID_PARAMETER;
}