ShellObjectWrapper Class

public abstract class ShellObjectWrapper : ShellObjectBase, IShellObject, IDisposable

protected ShellObjectWrapper(IShellService shellService, IShellObject wrappedShellObject)

Parameter	Type	Description
shellService	IShellService	The IShellService used to return this shell object's children.
wrappedShellObject	IShellObject	The IShellObject to be wrapped by this class.

public override bool AreChildrenLoaded { get; }

Property Value

bool:

true if the Children collection is loaded; otherwise, false.

Remarks

Since the Children collection is lazy-loaded when called, this property returns whether it has been loaded without triggering a load.

public override bool CanCreateChildFolder { get; }

Property Value

bool:

true if the shell object can create a child folder; otherwise, false. The default implementation of this property returns false.

Remarks

Only shell folders can create child folders.

public override bool CanHaveChildFolders { get; }

Property Value

bool:

true if the shell object may have child folders; otherwise, false. The default implementation of this property returns the IsFolder property value.

Remarks

Some shell objects can immediately return that they don't have any child folders, whereas others might require a query to determine if there are any.

public override bool CanRename { get; }

Property Value

bool:

true if the shell object may be renamed; otherwise, false. The default implementation of this property returns false.

public override IList<IShellObject> Children { get; }

Property Value

IList<IShellObject>:

The collection of child shell objects using lazy-loading.

public override string EditingName { get; }

Property Value

string:

The full user-friendly editing name of the shell object, if available.

Remarks

This value is usually the same as FileSystemPath, except that it can also return a special value to identify special shell objects.

public override ImageSource ExtraLargeIcon { get; set; }

Property Value

ImageSource:

The extra-large icon.

public override ImageSource ExtraLargeIconOverlay { get; set; }

Property Value

ImageSource:

The extra-large icon overlay.

public override string FileSystemPath { get; }

Property Value

string:

The file system path of the shell object, if available. The default implementation of this property returns null.

public override bool IsFolder { get; }

Property Value

bool:

true if the shell object is a folder, which is anything that can contain other shell objects; otherwise, false. The default implementation of this property returns true based on an applicable Kind property value.

public override bool IsLink { get; }

Property Value

bool:

true if the shell object is a link, meaning a shortcut to another shell object; otherwise, false. The default implementation of this property returns true based on an applicable Kind property value.

public override bool IsRemovable { get; }

Property Value

bool:

true if the shell object is on removable media or is a removable device; otherwise, false. The default implementation of this property returns false.

public override bool IsVirtual { get; }

Property Value

bool:

true if the shell object is not part of the file system (files, directories, or root directories); otherwise, false. The default implementation of this property returns true.

public override bool IsWatching { get; }

Property Value

bool:

true if the shell object's tree hierarchy is currently watching for change notifications; otherwise, false. The default implementation of this property returns false.

public override ShellObjectKind Kind { get; }

Property Value

ShellObjectKind:

A ShellObjectKind that specifies the kind of this shell object.

public override ImageSource LargeIcon { get; set; }

Property Value

ImageSource:

The large icon.

public override ImageSource LargeIconOverlay { get; set; }

Property Value

ImageSource:

The large icon overlay.

public override ImageSource MediumIcon { get; set; }

Property Value

ImageSource:

The medium icon.

public override ImageSource MediumIconOverlay { get; set; }

Property Value

ImageSource:

The medium icon overlay.

public override string Name { get; set; }

Property Value

string:

The name of the shell object.

public override string ParsingName { get; }

Property Value

string:

The full parsing name of the shell object, if available. The default implementation of this property returns the FileSystemPath property value.

Remarks

This value is usually the same as FileSystemPath, except that it can also return a special syntax to identify special shell objects.

public override string RelativeParsingName { get; }

Property Value

string:

The parent-relative parsing name of the shell object, if available.

Remarks

This value is usually the same as Name, except that it can also return a special syntax to identify special shell objects.

public override ImageSource SmallIcon { get; set; }

Property Value

ImageSource:

The small icon.

public override ImageSource SmallIconOverlay { get; set; }

Property Value

ImageSource:

The small icon overlay.

public override int SortOrder { get; set; }

Property Value

int:

A numeric sort order for sorting the shell object within other shell objects. The default value is 0.

public override SpecialFolderKind SpecialFolderKind { get; }

Property Value

SpecialFolderKind:

A SpecialFolderKind that specifies kind of special folder represented by this shell object, if applicable. The default implementation of this property returns None.

public override object ToolTip { get; set; }

Property Value

object:

The tool-tip object.

public IShellObject WrappedShellObject { get; }

Property Value

IShellObject:

The IShellObject that is wrapped by this class.

public override bool CreateChildFolder(string name)

Parameter	Type	Description
name	string	The name of the child folder.

Returns

bool:

true if the child folder was created; otherwise, false.

Remarks

Only shell folders can create child folders. The default implementation of this method does nothing and returns false.

protected override void Dispose(bool disposing)

Parameter	Type	Description
disposing	bool	true to release both managed and unmanaged resources; false to release only unmanaged resources.

Remarks

This method is called by the public Dispose method and the Finalize method. Dispose invokes this method with the disposing parameter set to true. Finalize invokes this method with disposing set to false.

public override void RefreshChildren()

public override bool StartWatching()

Returns

bool:

true if the shell object is watching its tree hierarchy; otherwise, false.

Remarks

The default implementation of this method does nothing, and returns false.

public override void StopWatching()

Remarks

The default implementation of this method does nothing.