ShellViewColumns Class

Class representing a collection of ShellViewColumns. It serves to control the visible columns in supported controls. Not supported on Windows XP.

Inheritance Hierarchy

SystemObject
Jam.ShellShellViewColumns

Namespace: Jam.Shell
Assembly: ShellBrowser.Core (in ShellBrowser.Core.dll) Version: 7.1

Syntax

C++

Copy

public class ShellViewColumns : IList<ShellViewColumn>, 
	ICollection<ShellViewColumn>, IEnumerable<ShellViewColumn>, IEnumerable, 
	INotifyCollectionChanged

Public Class ShellViewColumns
	Implements IList(Of ShellViewColumn), ICollection(Of ShellViewColumn), 
	IEnumerable(Of ShellViewColumn), IEnumerable, INotifyCollectionChanged

public ref class ShellViewColumns : IList<ShellViewColumn^>, 
	ICollection<ShellViewColumn^>, IEnumerable<ShellViewColumn^>, IEnumerable, 
	INotifyCollectionChanged

type ShellViewColumns =  
    class
        interface IList<ShellViewColumn>
        interface ICollection<ShellViewColumn>
        interface IEnumerable<ShellViewColumn>
        interface IEnumerable
        interface INotifyCollectionChanged
    end

The ShellViewColumns type exposes the following members.

Properties

	Name	Description
	Count	Gets the number of elements contained in the ICollectionT.
	IsReadOnly	Gets a value indicating whether the ICollectionT is read-only.
	Item	Gets or sets the element at the specified index.
	SortBy	Gets or sets the column the view is sorted by.
	SortDirection	Gets or sets the sort direction.

Top

Methods

	Name	Description
	Add(SHCOLUMNID)	Adds the specified column at the last position.
	Add(ShellViewColumn)	Adds a column to the collection.
	AutoSize	Resizes all columns to the auto-size width.
	Clear	Removes all items from the ICollectionT.
	Contains(SHCOLUMNID)	Determines whether the passed column is contained in the collection.
	Contains(ShellViewColumn)	Determines whether the ICollectionT contains a specific value.
	CopyTo	Copies the entire list to the array passed, starting at the passed index of the target array.
	DefaultSize	Resizes all columns to the default-size width.
	GetColumnName	Gets the caption of the column with the passed column key.
	GetColumnWidth	Returns the width of the column identified by the passed id.
	GetEnumerator	Returns an enumerator that iterates through the collection.
	GetSHColumnIds	Returns the columns the keys of the columns in collection.
	Hide	Removes the given column from the current view.
	IndexOf(SHCOLUMNID)	Returns the index of the column with the passed SHCOLUMNID.
	IndexOf(ShellViewColumn)	Determines the index of a specific item in the IListT.
	Insert(Int32, SHCOLUMNID)	Inserts a new column representing the passed SHCOLUMNID at the passed index.
	Insert(Int32, ShellViewColumn)	Inserts an item to the IListT at the specified index.
	Remove(SHCOLUMNID)	Removes the specified column.
	Remove(ShellViewColumn)	Removes the first occurrence of a specific object from the ICollectionT.
	RemoveAt	Removes the IListT item at the specified index.
	SetColumnName	Changes the name of the column identified by the passed id.
	SetColumns	Replaces the currently shown columns by the columns passed.
	SetColumnWidth	Sets the width of the column identified by the passed id.
	Show	Adds the column at its default position.

Top

Events

	Name	Description
	CollectionChanged	Occurs when collection has changed.

Top

Examples

The following examples control the columns displayed in the ExplorerBrowser.

Copy

explorerBrowser1.Columns.Clear();
explorerBrowser1.Columns.Add(SHCOLUMNID.ShellColumnName);
explorerBrowser1.Columns.Add(SHCOLUMNID.ShellColumnSize);
explorerBrowser1.Columns.Add(SHCOLUMNID.ShellColumnParentFolder);

Copy

//if you want to define the total set of columns at once, this version is much more performant than adding each column seperately.
explorerBrowser1.Columns.SetColumns(new List<SHCOLUMNID>()
{
    SHCOLUMNID.ShellColumnName,
    SHCOLUMNID.ShellColumnSize,
    SHCOLUMNID.ShellColumnElementType
});

Copy

if (IsMyMusic())
{
    //"Show" shows the column at its default position, but you can determine the position by using "Insert" or "Add"
    explorerBrowser1.Columns.Show(SHCOLUMNID.ShellColumnMusicTitlenumber);
    explorerBrowser1.Columns.Show(SHCOLUMNID.ShellColumnSummaryTitle);
    explorerBrowser1.Columns.Show(SHCOLUMNID.ShellColumnMusicArtist);
    explorerBrowser1.Columns.Show(SHCOLUMNID.ShellColumnMusicAlbum);
    explorerBrowser1.Columns.Show(SHCOLUMNID.ShellColumnMusicYear);
    explorerBrowser1.Columns[explorerBrowser1.Columns.Count - 1].Caption = "Custom title";
}

Copy

explorerBrowser1.Columns.Remove(SHCOLUMNID.ShellColumnSize); //Removes the Size column. If it doesn't exist it is skipped.

Reference

Jam.Shell Namespace