In This Topic ▼

LImageListControl::SortExt

Summary

Sorts the items in the ImageList Control based on their text or Extended Text attributes referenced in the pTextExt member of the LILITEM structure.

Syntax

#include "ltwrappr.h"

L_INT LImageListControl::SortExt(pSortOptions)

Parameters

pLILSORTOPTIONS pSortOptions

Pointer to the LILSORTOPTIONS structure that contains the sorting options to be used.

Returns

Value	Meaning
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

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

Platforms

Win32, x64.

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