ShellItem Class |
Represents a Windows Shell Item. An item can be a simple item or a folder.
Inheritance HierarchyNamespace: ShellBoost.Core
Assembly: ShellBoost.Core (in ShellBoost.Core.dll) Version: 1.8.3.0
SyntaxC#
public class ShellItem : IWithIdList
The ShellItem type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | ShellItem(ShellFolder, ShellItemId) |
Initializes a new instance of the ShellItem class.
|
| ShellItem(ShellFolder, Guid) |
Initializes a new instance of the ShellItem class.
This item's PIDL will be constructed using the parent's root PIDL (instead of the parent pidl) plus the passed in uniqueGuid.
|
| ShellItem(ShellFolder, FileInfo) |
Initializes a new instance of the ShellItem class for a physical file item.
|
| ShellItem(ShellFolder, ShellItemId, String) |
Initializes a new instance of the ShellItem class for a physical file item.
|
Properties| Name | Description | |
|---|---|---|
 | AssociationElementList |
Gets the association element list of this item.
|
| Attributes |
Gets or sets the System.SFGAOFlags property value.
|
| CanBeCached |
Gets or sets a value indicating whether this instance can be cached.
|
| CanCopy |
Gets or sets a value indicating whether this instance can be copied.
|
| CanDelete |
Gets or sets a value indicating whether this instance can be deleted.
|
| CanLink |
Gets or sets a value indicating whether this instance supports shortcut creation.
|
| CanMove |
Gets or sets a value indicating whether this instance can be moved.
|
| CanPaste |
Gets or sets a value indicating whether this instance supports clipboard paste operations.
This property value is the aggregation of CanMove, CanCopy and IsDropTarget values.
|
| CanRename |
Gets or sets a value indicating whether this instance can be renamed.
|
| DateAccessed |
Gets or sets the System.DateAccessed property value.
|
| DateCreated |
Gets or sets the System.DateCreated property value.
|
| DateModified |
Gets or sets the System.DateModified property value.
|
| DisplayName |
Gets or sets the System.ItemNameDisplay property value.
|
| FileName |
Gets or sets the System.FileName property value.
|
| FileSystemPath |
Gets or sets the physical file system path. A shell item does not need to have a corresponding file system path.
|
| FullDisplayName |
Gets this item's display name, that is, including the parent's full display name.
The full disply name is also what is used in the Windows Explorer's Address Bar.
|
| FullParsingName |
Gets this item's parsing name, that is, including the parent's full parsing name.
|
| HasPropertySheet |
Gets or sets a value indicating whether this instance supports the property sheet.
|
| Id |
Gets this item identifier, which is this item's PIDL last segment.
|
| IdList |
Gets this item's PIDL.
|
| IsDropTarget |
Gets or sets a value indicating whether this instance is a drop target.
|
| IsFolder |
Gets a value indicating whether this instance is a folder.
|
| IsHidden |
Gets or sets a value indicating whether this instance is hidden.
|
| IsPlaceholder |
Gets or sets a value indicating whether this instance is a placeholder.
|
| ItemType |
Gets or sets the System.ItemType property value.
|
| KindList |
Gets the Windows KIND list of this item.
|
| Parent |
Gets the parent folder.
|
| ParsingName |
Gets this item's parsing name.
|
| Perceived |
Gets the System.PerceivedType property value.
|
 | PropertyStore |
Gets the property store.
|
| ReadPropertiesFromShell |
Gets or sets a value indicating whether to read properties from shell, if FileSystemPath is not null, when they are not defined by this instance.
|
| Size |
Gets or sets the System.Size property value.
|
| Thumbnail |
Gets or sets this item's thumbnail.
|
Methods| Name | Description | |
|---|---|---|
| CommitProperties |
Commits the property store.
|
 | CreatePropertyStore |
Creates the property store instance.
|
| FreezePropertyStore |
Freezes the property store.
The property store can be frozen when a client asks for the property store as a whole.
Overriding this method allows you to add properties to the frozen store.
|
| GetContent |
Gets the content of this item.
|
| GetNullifiedPropertyValue(PropertyKey) |
Gets a string property key value. The string will be trimmed and converted to null if its length is 0.
|
| GetNullifiedPropertyValue(PropertyKey, String) |
Gets a string property key value. The string will be trimmed and converted to the default value if its length is 0.
|
| GetNullifiedPropertyValue(PropertyKey, IFormatProvider, String) |
Gets a string property key value. The string will be trimmed and converted to the default value if its length is 0.
|
| GetPropertyIndex |
Gets a property key index from this item's property store.
|
| GetPropertyValue(PropertyKey, Object) |
Gets a property key value.
|
| GetPropertyValueT(PropertyKey, T) |
Gets a typed property key value.
|
| GetPropertyValueT(PropertyKey, FuncT) |
Gets a typed property key value.
|
| GetUri |
Gets the URI corresponding to this item.
|
| HandleFileSystemSFGAO |
Handles flags for File System Shell item.
|
| Initialize |
Initializes this instance.
|
| InitializeFileSystem |
Initializes the file system. Called when the FileSystemPath property is set.
|
| IsPropertyWritable |
Determines whether the specified property key value is writable, from this item's property store.
|
| MapContextMenuCommand |
Maps a context menu command.
|
| MergeContextMenu |
Allows to add items to context menu.
|
| MergeContextMenuBottom |
Allows to add items to the bottom of the context menu.
|
| MergeContextMenuTop |
Allows to add items to the top of the context menu.
|
| MergeViewMenu |
Merges a view menu.
|
| ModifyContextMenuFlags |
The Shell is calling this method to ask for context menu flags modification.
|
| NotifyAttributes |
Notifies the Windows Shell that this item attributes have changed.
|
| NotifyCreate |
Notifies the Windows Shell that this item has been created.
|
| NotifyDelete |
Notifies the Windows Shell that this item has been deleted.
|
| NotifyRename(ShellItemId) |
Notifies the Windows Shell that this item has been renamed.
|
| NotifyRename(ShellItemIdList) |
Notifies the Windows Shell that this item has been renamed.
|
| NotifyUpdate |
Notifies the Windows Shell that this item has been updated.
|
| OnAssociationElementListChanged |
Called when the AssociationElementList changes.
|
| OnDragDropTarget |
Called on drag and drop events.
|
| OnMenuInvoke |
Called when a menu is invoked.
|
| RefreshShellViews |
Refreshes all shell views.
|
| RefreshShellViews(RefreshViewsOptions) |
Refreshes the shell views with options.
|
| ResetShellThumbnail |
Resets the Windows Explorer thumbnail cache.
|
| SetPropertyValue(PropertyDescription, Object) |
Sets a property value to this item's property store.
|
| SetPropertyValue(PropertyKey, Object) |
Sets a property key value to this item's property store.
|
| ShowDefaultContextMenu |
Determines if the default context menu should be shown.
|
| ToString |
Returns a String that represents this instance.
(Overrides ObjectToString.) |
| TryCompare(ShellItem, ShellFolderColumn, CompareIdReturnValue) |
Compares this instance column with another.
|
| TryCompare(ShellItem, SHCIDS, CompareIdReturnValue) |
Compares this instance with another.
|
| TryCompareAllFields |
Compares this instance all columns with another.
|
| TryGetContent |
Gets the content of this item.
|
| TryGetFileSystemValue |
Gets a property key value in the case of a File System Shell item.
|
| TryGetPropertyAt |
Gets the property key at a given index, from this item's property store.
|
| TryGetPropertyValue(PropertyKey, Object) |
Gets a property key value.
|
| TryGetPropertyValueT(PropertyKey, T, IFormatProvider) |
Gets a property key value and convert it to the expected type if needed.
|
| UnmergeViewMenu |
Unmerges the view menu.
|
Fields| Name | Description | |
|---|---|---|
  | DefaultItemAttributes |
The default item attributes.
|
Extension Methods| Name | Description | |
|---|---|---|
 | OpenView |
Opens a Windows Explorer window.
(Defined by Extensions.) |
| WithPointer(ActionIntPtr) | Overloaded.
Allocates a buffer, runs the specified action and free the buffer.
(Defined by Extensions.) |
| WithPointerT(FuncIntPtr, T) | Overloaded.
Allocates a buffer, runs the specified function and free the buffer.
(Defined by Extensions.) |
See Also