ShellBrowser Delphi Components Documentation
ContentsIndexHome
PreviousUpNext
Jam.Shell.Types.TItemIdListDisplayNameFormat

This enumeration contains different formats to retrieve the IItemIdList.DisplayName of an ItemIdList.

Syntax
Pascal
TItemIdListDisplayNameFormat = (
  dnfNormal,
  dnfInFolder,
  dnfPath,
  dnfPhysicalPath,
  dnfRelativeForAddressBar,
  dnfRelativeParsing,
  dnfAbsoluteParsing,
  dnfForExplorer,
  dnfPreferPhysical
);
Members 
Description 
dnfNormal 
Returns the displayname relative to the parent folder. 
dnfInFolder 
Returns the path relative to the parent folder. Slightly different results than dnfNormal for UNC-Paths and files in archives.  
dnfPath 
Returns the absolute path. Also elements without physical path (i.e. special folders or elements on an attached mobile device) return a value using dnfPath. 
dnfPhysicalPath 
Returns the item's file system path, if it has one. Passing this value to IItemIdList.DisplayName will not return any cached value, and contrary to IItemIdList.Path it will return an empty string for invalid elements. 
dnfRelativeForAddressBar 
Returns the relative path. Compared to dnfNormal and dnfInFolder it returns names including the extension, even if extension are hidden in Windows Explorer. 
dnfRelativeParsing 
Returns the relative path that is often not suitable to display (returns e.g. Folder-GUIDs for SpecialFolders or device-ids for usb storage). 
dnfAbsoluteParsing 
Returns an absolute path that is often not suitable to display(returns e.g. Folder-GUIDs for SpecialFolders or device-ids for usb storage). 
dnfForExplorer 
Internally used - a combination of dnfAbsoluteParsing and dnfPath, that can be passed to explorer.exe. 
dnfPreferPhysical 
Returns the absolute physical path if available. If not available, returns the DisplayPath (dnfPath).