Name 

Description 

 

constructor Create(const pShellFolder: IShellFolder; const pRelativeIdList: IItemIdList); overload; 

Creates an absolute ItemIdList from the passed IShellFolder and relative ItemIdList. 

 

constructor Create(const pShellItem: IShellItem); overload; 

Constructor for TJamItemIdList for an existing IShellItem. 

 

constructor Create(aItemIdList: PItemIdList; pOwnsPointer: TItemIdListOwnership = iloOwnsMemory); overload; 

Constructor for TJamItemIdList for an existing PItemIdList. 

 

constructor Create(const pPath: UnicodeString; pShellFolder: IShellFolder = nil; pWindowHandleForLogonDialog: THandle = 0); overload; 

Constructor for TJamItemIdList for a file system path. 

 

constructor CreateSimpleIdList(const pPath: String); 

Constructor that creates a simple ItemIdList for a file system path. 

 

destructor Destroy; override; 

The destructor for this class. Do not call directly, or Free(). 

 

Name 

Description 

 

function GetInfo(const pLevel: TItemIdListInfoLevel = TItemIdListInfoLevel.Normal): string; 

Retrieves information on the ItemIdList that can be used for debugging purposes.  

 

Name 

Description 

 

procedure InvokeCommand(const pCommand: TShellCommand); 

Executes a shell command on the objects selected in the control.  

 

Name 

Description 

 

function CompareTo(const pItemIdList2: IItemIdList; pComparison: TItemIdListComparison = ilcDisplay): HRESULT; 

Compares the given ItemIdList to this instance by their name 

 

function Concat(const pItemIdList2: IItemIdList): IItemIdList; 

Concatenates this instance and the given ItemIdList to a new one. 

 

function CreateNewFolder(pNewFolderName: string = ''): IItemIdList; 

Creates a new folder inside the folder represented by the current instance.  

 

function Depth: Integer; 

Returns the number of elements in this ItemIdList. 

 

function DisplayName(pDisplayFormat: TItemIdListDisplayNameFormat = dnfInFolder): UnicodeString; 

Returns a string for this item suitable for displaying 

 

function DisplayPath: UnicodeString; 

Returns a string representing the path for this item suitable for displaying. 

 

function Equals(const pItemIdList2: IItemIdList; pComparison: TItemIdListComparison = ilcDisplay): Boolean; 

Returns True if the given ItemIdList is the same as this instance. 

 

function GetLastPart: IItemIdList; 

Returns the last (relative) part of the ItemIdList. 

 

function GetParent: IItemIdList; 

Returns the parent ItemIdList of this ItemIdList.  

 

function GetPropertyValue(const pShellColumnId: TShellColumnId): TShellPropertyValue; 

Returns meta information on the item identified by this ItemIdList. 

 

function GetShellInformation(const pSHColumns: array of TShellColumnId; pFirstOnly: Boolean = True): string; 

Returns meta information on the item identified by this ItemIdList. 

 

function GetStartItemIdList(pFragments: Integer): IItemIdList; 

Returns a beginning part of this ItemIdList. 

 

function HasAttributes(pAttributes: UINT): Boolean; 

Checks if the object represented by this ItemIdList has the given attributes. 

 

function IsAbsolute: Boolean; 

Checks if the ItemIdList is relative or absolute. 

 

function IsFolder: Boolean; 

Checks if this ItemIdList refers to a folder. 

 

function IsInvalid: Boolean; 

Returns if this instance contains a valid ItemIdList or not 

 

function IsParentOf(const pChildItemIdList: IITemIdList; pAcceptsEquals: Boolean = true; const pComparisonType: TItemIdListComparison = ilcExact): Boolean; overload; 

Checks if the given ItemIdList is a child ItemIdList of this instance. 

 

function IsResolved: Boolean; 

Returns true if the instance is resolved. In the case of TJamItemIdList this means that an ItemIdList that was created with a path has already been accessed.  

 

function IsSlow: Boolean; 

Returns true if the instance will very likely be slow. This affects e.g. iterating it using the TShellBrowser.Next method./> Currently SpecialFolder SF_Network and SF_Nethood are regarded as being slow.  

 

function IsSpecialFolder(pSpecialFolderToCheck: TJamShellFolder): Boolean; 

Returns if this ItemIdList one of the given special folders 

 

function LinkTarget: IItemIdList; 

In case the this ItemIdList refers to a shell shortcut, we returns the target ItemdIdList; If not, we return self. 

 

function Name: UnicodeString; 

Returns the physical name of the item represented by this ItemIdList 

 

function Path: UnicodeString; 

Returns the file system path of this ItemIdList if it is a file system object. 

 

function Reload: Boolean; 

Reloads the ItemIdList by updating the ShellItem and reassigning the pidl. Turns non-functional ItemIdLists as they are sent by ShellNotifications into functional ones. 

 

procedure Rename(pNewName: string; pWindowHandle: THandle = 0; const pUpdatePidl: Boolean = true); 

Renames the file system object represented by this instance.  

 

procedure SetPropertyValue(const pKey: TShellColumnId; const pValue: TShellPropertyValue); 

Sets metadata of a file using the property system of Windows.  

 

function ShellItem: IShellItem; 

Retrieves the IShellItem interface of this ItemIdList. 

 

function SpecialFolder: TJamShellFolder; 

Returns if this ItemIdList is a special folder 

 

function WindowsPointer: pItemIdList; 

Returns the actual Windows Pointer that is wrapped by this instance. It is needed to pass it to Windows API calls. 

 

Name 

Description 

 

function GetFormattedString(const pMetaData: TShellColumnId): String; stdcall; 

Returns information about a meta data information as string. 

 

function GetPlainValue(const pMetaData: TShellColumnId): Int64; stdcall; 

Query numeric meta data information of the current object. 

 

Name 

Description 

 

function CompareTo(const pItemIdList2: IItemIdList; pComparison: TItemIdListComparison = ilcDisplay): HRESULT; 

Compares the given ItemIdList to this instance by their name 

 

function Concat(const pItemIdList2: IItemIdList): IItemIdList; 

Concatenates this instance and the given ItemIdList to a new one. 

 

class function CreateForSpecialFolder(pSpecialFolder: TJamShellFolder; pFromCache: Boolean = True): IItemIdList; overload; 

Static factory method that returns an IItemIdList for a given special folder. 

 

class function CreateForSpecialFolder(pDisplayName: UnicodeString): IItemIdList; overload; 

Static factory method that returns an IItemIdList for the special folder identified by pDisplayName 

 

function CreateNewFolder(pNewFolderName: string = ''): IItemIdList; 

Creates a new folder inside the current ItemIdList.  

 

class function CreateSearchFolder(const pQuery: string; pSearchScope: IItemIdList): IItemIdList; deprecated; 

Static factory method that creates a "search folder" with a specified search query and scope and returns this folder as IItemIdList. 

 

function Depth: Integer; 

Returns the number of elements in this ItemIdList. 

 

function DisplayName(pDisplayFormat: TItemIdListDisplayNameFormat = dnfInFolder): UnicodeString; 

Returns a string for this item suitable for displaying 

 

function DisplayPath: UnicodeString; 

Returns a string representing the path for this item suitable for displaying. 

 

function Equals(const pItemIdList2: IItemIdList; pComparison: TItemIdListComparison = ilcDisplay): Boolean; reintroduce; 

Returns True if the given ItemIdList is the same as this instance. 

 

class function GetElementNo(const pIdList: IItemIdList; pElementsToSkip: Integer): PItemIdList; 

Returns the pointer to a trailing part of the given ItemIdList. 

 

function GetInfo(const pLevel: TItemIdListInfoLevel = TItemIdListInfoLevel.Normal): string; 

Retrieves information on the ItemIdList that can be used for debugging purposes. Only accesses data that has already been retrieved.  

 

function GetLastPart: IItemIdList; 

Returns the last (realtive) part of the ItemIdList. 

 

function GetParent: IItemIdList; 

Returns the parent ItemIdList of this ItemIdList.  

 

function GetPropertyValue(const pShellColumnId: TShellColumnId): TShellPropertyValue; 

Returns meta information on the item identified by this ItemIdList. 

 

function GetShellInformation(const pSHColumns: array of TSHellColumnID; pFirstOnly: Boolean = True): string; 

Returns meta information on the item identified by this ItemIdList.  

 

function GetStartItemIdList(pFragments: Integer): IItemIdList; 

Returns a beginning part of this ItemIdList. 

 

function HasAttributes(pAttributes: UINT): Boolean; 

Checks if the object represented by this ItemIdList has the given attributes. 

 

procedure InvokeCommand(const pCommand: TShellCommand); 

Executes a shell command on the objects selected in the control.  

 

function IsAbsolute: Boolean; 

Checks if the ItemIdList is relative or absolute. 

 

function IsFolder: Boolean; 

Checks if this ItemIdList refers to a folder. 

 

function IsInvalid: Boolean; 

Returns if this instance contains a valid ItemIdList or not 

 

class function IsNetworkPidl(const pFullPidl: IItemIdList): Boolean; 

Check if an ItemIdList list is part of the network. 

 

function IsParentOf(const pChildItemIdList: IITemIdList; pAcceptsEquals: Boolean = true; const pComparisonType: TItemIdListComparison = ilcExact): Boolean; overload; 

Checks if the given ItemIdList is a child ItemIdList of this instance. 

 

class function IsParentOf(const pParentFolder: TJamShellFolder; const pChildItemIdList: IItemIdList; const pAcceptsEquals: boolean = true): boolean; overload; 

Checks if the given ItemIdList is a child ItemIdList of the passed TJamShellFolder. 

 

function IsResolved: Boolean; 

Returns true if the instance is resolved. In the case of TJamItemIdList this means that an ItemIdList that was created with a path has already been accessed.  

 

function IsSlow: Boolean; virtual; 

Returns true if the instance will very likely be slow. This affects e.g. iterating it using the TShellBrowser.Next method./> Currently SpecialFolder SF_Network and SF_Nethood are regarded as being slow.  

 

function IsSpecialFolder(pSpecialFolderToCheck: TJamShellFolder): Boolean; 

Returns if this ItemIdList one of the given special folders 

 

function LinkTarget: IItemIdList; 

In case the this ItemIdList refers to a shell shortcut, we returns the target ItemdIdList; If not, we return self. 

 

function Name: UnicodeString; 

Returns the physical name of the item represented by this ItemIdList 

 

class function Parse(pPath: UnicodeString; pWindowHandleForLogonDialog: THandle = 0; pCompleteScan: boolean = false): IItemIdList; 

Static factory method that returns an IItemIdList for the pPath that is passed. 

 

function Path: UnicodeString; 

Returns the file system path of this ItemIdList if it is a file system object. 

 

function Reload: Boolean; 

Reloads the ItemIdList by updating the ShellItem and reassigning the pidl. Turns non-functional (simple) ItemIdLists as they are sent by ShellNotifications into functional ones. 

 

procedure Rename(pNewName: string; pWindowHandle: THandle = 0; const pUpdatePidl: Boolean = true); 

Renames the file system object represented by this instance.  

 

procedure SetPropertyValue(const pKey: TShellColumnId; const pValue: TShellPropertyValue); 

Sets metadata of a file using the property system of Windows.  

 

function ShellItem: IShellItem; 

Retrieves the IShellItem interface of this ItemIdList. 

 

function SpecialFolder: TJamShellFolder; 

Returns if this ItemIdList is a special folder 

 

function WindowsPointer: pItemIdList; 

Returns the actual Windows Pointer that is wrapped by this instance. It is needed to pass it to Windows API calls.