ShellListView Class

public class ShellListView : TreeListView

public ShellListView()

[Browsable(false)]
protected override sealed UIAssemblyInfoBase AssemblyInfo { get; }

Property Value

UIAssemblyInfoBase

protected override bool CanExpandAll { get; }

Property Value

bool:

true if any expand all operations can occur; otherwise, false. The default value is true.

public bool CanIncludeFiles { get; set; }

Property Value

bool:

true if files should be displayed; otherwise, false. The default value is true.

public bool CanIncludeFolders { get; set; }

Property Value

bool:

true if folders should be displayed; otherwise, false. The default value is true.

public bool CanIncludeLinks { get; set; }

Property Value

bool:

true if links should be displayed; otherwise, false. The default value is true.

public bool CanNavigateIntoChildFolders { get; set; }

Property Value

bool:

true if the default action for folders should be to navigate into the child folder; otherwise, false. The default value is true.

public bool CanResetSortOnRootShellFolderChange { get; set; }

Property Value

bool:

true if the list's sort should be reset when changing the RootShellFolder; otherwise, false. The default value is true.

public bool CanUseThumbnails { get; set; }

Property Value

bool:

true if thumbnail images can be used in place of icons when available; otherwise, false. The default value is true.

Remarks

Thumbnails are only used in certain LayoutMode options that render larger images.

public DataTemplate? ColumnHeaderTemplate { get; set; }

Property Value

DataTemplate

public IShellService? DefaultShellService { get; set; }

Property Value

IShellService:

The default value is an instance of WindowsShellService.

Remarks

This property is not used if the RootShellFolder property is set directly.

public DataTemplate? DetailsLayoutModeItemTemplate { get; set; }

Property Value

DataTemplate

public DataTemplate? ExtraLargeIconsLayoutModeItemTemplate { get; set; }

Property Value

DataTemplate

public bool IsDefaultItemContextMenuEnabled { get; set; }

Property Value

bool:

true if the default context menu is enabled for shell objects; otherwise false. The default value is true.

public bool IsRenamingEnabled { get; set; }

Property Value

bool:

true if objects can be renamed; otherwise, false. The default value is true.

Remarks

The shell objects themselves must also support renaming via CanRename.

public DataTemplate? LargeIconsLayoutModeItemTemplate { get; set; }

Property Value

DataTemplate

public ShellListViewLayoutMode LayoutMode { get; set; }

Property Value

ShellListViewLayoutMode:

A ShellListViewLayoutMode value indicating the item layout mode. The default value is Details.

public DataTemplate? ListLayoutModeItemTemplate { get; set; }

Property Value

DataTemplate

public DataTemplate? MediumIconsLayoutModeItemTemplate { get; set; }

Property Value

DataTemplate

public IShellObject? RootShellFolder { get; set; }

Property Value

IShellObject

public string? RootShellFolderParsingName { get; set; }

Property Value

string

Remarks

Setting this property will update the RootShellFolder property.

public SpecialFolderKind RootSpecialFolderKind { get; set; }

Property Value

SpecialFolderKind

Remarks

Setting this property will update the RootShellFolder property.

public DataTemplate? SmallIconsLayoutModeItemTemplate { get; set; }

Property Value

DataTemplate

public ColumnSortDirection SortDirection { get; set; }

Property Value

ColumnSortDirection:

The default value is Ascending.

See Also

• SortShellPropertyKey

public object? SortShellPropertyKey { get; set; }

Property Value

object

See Also

• SortDirection

public void DisposeShellInstances()

Remarks

This method should be called when the control will no longer be used since it ensures any unmanaged resources held by the shell object hierarchy and shell service are disposed.

protected override DependencyObject GetContainerForItemOverride()

Returns

DependencyObject:

The element that is used to display the given item.

[Obsolete("This method to manually notify of a DPI change was only necessary for .NET Framework targets prior to .NET 4.6.2 and is no longer necessary since DPI changes are now processed automatically.")]
public void NotifyDpiChanged()

Remarks

This method is only included for backwards compatibility and is no longer necessary.

public override void OnApplyTemplate()

protected override void OnColumnHeaderTapped(TreeListViewColumnEventArgs e)

Parameter	Type	Description
e	TreeListViewColumnEventArgs	The event data.

Remarks

This method has no default implementation. Because an intermediate class in the inheritance might implement this method, we recommend that you call the base implementation in your implementation.

protected override void OnContextMenuOpening(ContextMenuEventArgs e)

Parameter	Type	Description
e	ContextMenuEventArgs	The RoutedEventArgs that contains the event data.

protected override void OnDpiChanged(DpiScale oldDpi, DpiScale newDpi)

Parameter	Type	Description
oldDpi	DpiScale	The previous DPI scale setting.
newDpi	DpiScale	The new DPI scale setting.

protected override void OnItemDefaultActionExecuting(TreeListBoxItemEventArgs e)

Parameter	Type	Description
e	TreeListBoxItemEventArgs	The event data.

Remarks

This method has no default implementation. Because an intermediate class in the inheritance might implement this method, we recommend that you call the base implementation in your implementation.

protected override void OnItemMenuRequested(TreeListBoxItemMenuEventArgs e)

Parameter	Type	Description
e	TreeListBoxItemMenuEventArgs	The event data.

Remarks

This method has no default implementation. Because an intermediate class in the inheritance might implement this method, we recommend that you call the base implementation in your implementation.

protected override void ProcessKeyDown(KeyEventArgs e)

Parameter	Type	Description
e	KeyEventArgs	The event data.

public void RefreshColumns()

public static readonly DependencyProperty CanIncludeFilesProperty

public static readonly DependencyProperty CanIncludeFoldersProperty

public static readonly DependencyProperty CanIncludeLinksProperty

public static readonly DependencyProperty CanNavigateIntoChildFoldersProperty

public static readonly DependencyProperty CanResetSortOnRootShellFolderChangeProperty

public static readonly DependencyProperty CanUseThumbnailsProperty

public static readonly DependencyProperty ColumnHeaderTemplateProperty

public static readonly DependencyProperty DefaultShellServiceProperty

public static readonly DependencyProperty DetailsLayoutModeItemTemplateProperty

public static readonly DependencyProperty ExtraLargeIconsLayoutModeItemTemplateProperty

public static readonly DependencyProperty IsDefaultItemContextMenuEnabledProperty

public static readonly DependencyProperty IsRenamingEnabledProperty

public static readonly DependencyProperty LargeIconsLayoutModeItemTemplateProperty

public static readonly DependencyProperty LayoutModeProperty

public static readonly DependencyProperty ListLayoutModeItemTemplateProperty

public static readonly DependencyProperty MediumIconsLayoutModeItemTemplateProperty

public static readonly DependencyProperty RootShellFolderParsingNameProperty

public static readonly DependencyProperty RootShellFolderProperty

public static readonly DependencyProperty RootSpecialFolderKindProperty

public static readonly DependencyProperty SmallIconsLayoutModeItemTemplateProperty

public static readonly DependencyProperty SortDirectionProperty

public static readonly DependencyProperty SortShellPropertyKeyProperty