SIGDN enumeration

Requests the form of an item's display name to retrieve through IShellItem::GetDisplayName and SHGetNameFromIDList.

Syntax


typedef enum _SIGDN { 
  SIGDN_NORMALDISPLAY                = 0x00000000,
  SIGDN_PARENTRELATIVEPARSING        = (int)0x80018001,
  SIGDN_DESKTOPABSOLUTEPARSING       = (int)0x80028000,
  SIGDN_PARENTRELATIVEEDITING        = (int)0x80031001,
  SIGDN_DESKTOPABSOLUTEEDITING       = (int)0x8004c000,
  SIGDN_FILESYSPATH                  = (int)0x80058000,
  SIGDN_URL                          = (int)0x80068000,
  SIGDN_PARENTRELATIVEFORADDRESSBAR  = (int)0x8007c001,
  SIGDN_PARENTRELATIVE               = (int)0x80080001,
  SIGDN_PARENTRELATIVEFORUI          = (int)0x80094001
} SIGDN;

Constants

SIGDN_NORMALDISPLAY

0x00000000. Returns the display name relative to the parent folder. In UI this name is generally ideal for display to the user.

SIGDN_PARENTRELATIVEPARSING

(int)0x80018001. Returns the parsing name relative to the parent folder. This name is not suitable for use in UI.

SIGDN_DESKTOPABSOLUTEPARSING

(int)0x80028000. Returns the parsing name relative to the desktop. This name is not suitable for use in UI.

SIGDN_PARENTRELATIVEEDITING

(int)0x80031001. Returns the editing name relative to the parent folder. In UI this name is suitable for display to the user.

SIGDN_DESKTOPABSOLUTEEDITING

(int)0x8004c000. Returns the editing name relative to the desktop. In UI this name is suitable for display to the user.

SIGDN_FILESYSPATH

(int)0x80058000. Returns the item's file system path, if it has one. Only items that report SFGAO_FILESYSTEM have a file system path. When an item does not have a file system path, a call to IShellItem::GetDisplayName on that item will fail. In UI this name is suitable for display to the user in some cases, but note that it might not be specified for all items.

SIGDN_URL

(int)0x80068000. Returns the item's URL, if it has one. Some items do not have a URL, and in those cases a call to IShellItem::GetDisplayName will fail. This name is suitable for display to the user in some cases, but note that it might not be specified for all items.

SIGDN_PARENTRELATIVEFORADDRESSBAR

(int)0x8007c001. Returns the path relative to the parent folder in a friendly format as displayed in an address bar. This name is suitable for display to the user.

SIGDN_PARENTRELATIVE

(int)0x80080001. Returns the path relative to the parent folder.

SIGDN_PARENTRELATIVEFORUI

(int)0x80094001. Introduced in Windows 8.

Remarks

Different forms of an item's name can be retrieved through the item's properties, including those listed here. Note that not all properties are present on all items, so only those appropriate to the item will appear.

Requirements

Minimum supported client

Windows XP with SP1 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

 

 

Show: