LImageListControl::SortExt

#include "ltwrappr.h"

L_INT LImageListControl::SortExt(pSortOptions)

/* pointer to a structure */

Sorts 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
pSortOptions	Pointer to the LILSORTOPTIONS structure that contains the sorting options to be used.

Returns

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

Comments

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

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

Required DLLs and Libraries

LTDISLTFILLTIMG

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:	LImageListControl::Sort, LImageListControl::GetColumnCount, LImageListControl::Clear
Topics:	Using the ImageList Control
	Raster Image Functions: Displaying Images

Example

L_INT LImageListControl__SortExtExample(HWND hWnd, LImageListControl& ImgList)
{
   L_INT nRet;
   HWND hList;
   LILSORTOPTIONS SortOptions; 
   if(IsWindow(hWnd)) 
   {
      hList = ImgList.CreateControl(hWnd, 0) ;
      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 */
      nRet = ImgList.SortExt(&SortOptions); 
      if(nRet != SUCCESS)
         return nRet;
      /* update the control */
      RedrawWindow( hWnd, NULL, NULL, RDW_INVALIDATE | RDW_UPDATENOW | RDW_ERASE); 
   }
   return SUCCESS;
}