ShellFoldermGetDisplayName Enumeration

Defines the values used with the GetDisplayNameOf(PIDL, ShellFoldermGetDisplayName) and SetNameOf(IntPtr, PIDL, String, ShellFoldermGetDisplayName, PIDL) methods to specify the type of file or folder names used by those methods.

Definition

Namespace: DevCase.Win32.Enums
Assembly: DevCase.net48 (in DevCase.net48.dll) Version: 6.0.0.0 (6.0)
XMLNS for XAML: Not mapped to an xmlns.
[FlagsAttribute]
public enum ShellFoldermGetDisplayName

Remarks

Members

Normal 0 When not combined with another flag, return the parent-relative name that identifies the item, suitable for displaying to the user.

This name often does not include extra information such as the file name extension and does not need to be unique.

This name might include information that identifies the folder that contains the item. For instance, this flag could cause GetDisplayNameOf(PIDL, ShellFoldermGetDisplayName) to return the string "username (on Machine)" for a particular user's folder.

InFolder 1 The name is relative to the folder from which the request was made. This is the name display to the user when used in the context of the folder. For example, it is used in the view and in the address bar path segment for the folder.

This name should not include disambiguation information— for instance "username" instead of "username (on Machine)" for a particular user's folder.

Use this flag in combinations with ForParsing and ForEditing.

ForEditing 4,096 The name is used for in-place editing when the user renames the item.
ForaddressBar 16,384 The name is displayed in an address bar combo box.
ForParsing 32,768 The name is used for parsing. That is, it can be passed to ParseDisplayName(IntPtr, IBindCtx, String, UInt32, PIDL, ShellItemAttributesMask) to recover the object's PIDL.

The form this name takes depends on the particular object.

When ForParsing is used alone, the name is relative to the desktop.

When combined with InFolder, the name is relative to the folder from which the request was made.

See Also