ShellThumbnail Class

Control that displays the thumbnail of a shell item.

Inheritance Hierarchy

SystemObject
  System.Windows.ThreadingDispatcherObject
    System.WindowsDependencyObject
      System.Windows.MediaVisual
        System.WindowsUIElement
          System.WindowsFrameworkElement
            System.Windows.ControlsControl
              Jam.Shell.WPF.ControlsShellThumbnail

Namespace: Jam.Shell.WPF.Controls
Assembly: ShellBrowserWPF (in ShellBrowserWPF.dll) Version: 1.3.1

Syntax

C++

Copy

public class ShellThumbnail : Control, 
	IShellControlConnectorTarget

Public Class ShellThumbnail
	Inherits Control
	Implements IShellControlConnectorTarget

public ref class ShellThumbnail : public Control, 
	IShellControlConnectorTarget

type ShellThumbnail =  
    class
        inherit Control
        interface IShellControlConnectorTarget
    end

The ShellThumbnail type exposes the following members.

Constructors

	Name	Description
	ShellThumbnail	Default constructor.

Top

Properties

	Name	Description
	ImageSize	Define a SystemImageListSize if you don't want to automatically fill the available space.
	InitialThumbnailSize	Defines a thumbnail size, that is used if the current component width is not set yet.
	Location	The location of the folder to be displayed. This is a dependency property.
	Overlay	Holds the overlay as ImageSource. It is only displayed if Overlays is set. This is a dependency property.
	Overlays	Gets or sets a value indicating whether overlays (like the arrow for .lnk files) should be displayed in the thumbnail or icon. Default is true.
	Path	Gets or sets the full pathname of the file/shell item to be displayed.
	ShellControlConnector	Gets or sets a ShellControlConnector.
	SpecialFolder	Gets or sets the special folder to be displayed.
	Stretch	Gets or sets the Stretch value for the thumbnail or icon. This is a dependency property.
	StretchDirection	Gets or sets the stretch direction. See StretchDirection
	Thumbnail	Holds the thumbnail as ImageSource.
	UseContentType	Gets or sets the content type of this instance.
	Version	The current version of ShellBrowser Components WPF.

Top

Methods

	Name	Description
	BeginUpdate	Begins an update. During an update the thumbnail will not be re-loaded in a different size.
	EndUpdate	Ends an update. The last EndUpdate will refresh the thumbnail.
	FolderChanged	Displays the thumbnail of the passed folder according to the settings.
	IsUpdating	Query if this object is currently updating, i.e. if a BeginUpdate has been called.
	OnApplyTemplate	Saves the thumbnail and overlay image to be able to make adjustments. (Overrides FrameworkElementOnApplyTemplate.)
	OnPropertyChanged	Invoked whenever the effective value of any dependency property on this FrameworkElement has been updated. The specific dependency property that changed is reported in the arguments parameter. Overrides OnPropertyChanged(DependencyPropertyChangedEventArgs). (Overrides FrameworkElementOnPropertyChanged(DependencyPropertyChangedEventArgs).)
	OnRenderSizeChanged	Executes the render size changed action. (Overrides FrameworkElementOnRenderSizeChanged(SizeChangedInfo).)
	OnThumnbailLoaded	Calls the ThumbnailLoaded event
	Refresh	Reloads the thumbnail.
	SelectedFileChange	Displays the thumbnail of the passed folder according to the settings.

Top

Events

	Name	Description
	ThumbnailLoaded	Event is thrown when the control has finished loading the image.

Top

Fields

	Name	Description
	LocationProperty	The DependencyProperty for Location.
	OverlayProperty	DependencyProperty for Overlay.
	StretchDirectionProperty	DependencyProperty for StretchDirection.
	StretchProperty	DependencyProperty for Stretch. This enables animation, styling, binding, etc...
	ThumbnailProperty	DependencyProperty for Thumbnail.

Top

Remarks

Depending on the UseContentType property it will either load an icon using the SystemImageList or a thumbnail. The size of the displayed icon or thumbnail can be controled using the ImageSize and StretchProperty. The file or item to show the thumbnail for can be set via the Location dependency property or the Path or SpecialFolder properties.

Examples

The following example shows how to use a ShellThumbnail containing small icons in a datatemplate of a ListView displaying a JamItemIdListCollection.

XAML

Copy

<ListView Name="listView1" ItemsSource="{Binding CurrentDirectory}">
    <ListView.Resources>
        <DataTemplate DataType="{x:Type shellbrowser:ItemIdList}">
            <StackPanel Orientation="Horizontal">
                <shlbr:ShellThumbnail ImageSize="SmallIcons" Location="{Binding}"/>
                <TextBlock Padding="10, 0, 0, 0" Text="{Binding Path=Caption}"/>
            </StackPanel>
        </DataTemplate>
    </ListView.Resources>
    <ListView.ContextMenu>
        <!-- Shows the shell context menu for the ItemIdLists contained in SelectedItemIdLists - a JamShellItemCollection held in the viewmodel and updated to represent the ListView's SelectedItems property. -->
        <shlbr:ShellContextMenu ShellItems="{Binding SelectedItemIdLists}"/>
    </ListView.ContextMenu>
</ListView>

Examples

A standalone thumbnail displaying the thumbnail of the Windows folder.

XAML

Copy

<shlbr:ShellThumbnail UseContentType="PreferThumbnail" SpecialFolder="{x:Static shellbrowser:ShellFolder.Downloads}"/>

Reference

Jam.Shell.WPF.Controls Namespace