ThumbnailImage Class

Use this component to display a thumbnail image of a file or folder. The same thumbnail image that the Windows Explorer uses will be shown. The Windows Shell does not supply a thumbnail image for all objects. You may either set the Path property to set a path to a file or folder for which the thumbnail image should be displayed. Or you may synchronize it to a ShellListView or ShellTreeView component using the ShellControlConnector property.

Inheritance Hierarchy

SystemObject
  SystemMarshalByRefObject
    System.ComponentModelComponent
      System.Windows.FormsControl
        System.Windows.FormsScrollableControl
          System.Windows.FormsPanel
            Jam.ShellThumbnailImage

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

Syntax

C++

Copy

public class ThumbnailImage : Panel, 
	IShellControl, IShellControlConnectorTarget, ISupportInitialize, ISupportInitializeNotification

Public Class ThumbnailImage
	Inherits Panel
	Implements IShellControl, IShellControlConnectorTarget, ISupportInitialize, ISupportInitializeNotification

public ref class ThumbnailImage : public Panel, 
	IShellControl, IShellControlConnectorTarget, ISupportInitialize, ISupportInitializeNotification

type ThumbnailImage =  
    class
        inherit Panel
        interface IShellControl
        interface IShellControlConnectorTarget
        interface ISupportInitialize
        interface ISupportInitializeNotification
    end

The ThumbnailImage type exposes the following members.

Constructors

	Name	Description
	ThumbnailImage	Initializes a new instance of the ThumbnailImage class.

Top

Properties

	Name	Description
	Enabled	Indicates whether the control is enabled.
	IconsAsThumnbnails	If set to true (default) the component uses icons if the shown file system element does not supply a thumbnail. Set false if only thumbnails are to be used.
	Image	Readonly property, which contains the currently shown thumbnail image.
	ImageHeight	Gets the height of the image.
	ImageWidth	Returns the width that is used for the image.
	IsInitialized	Gets a value indicating whether the component is initialized.
	ItemIdList	Gets or sets the absolute ItemIdList that should be/is displayed.
	Path	The Path property contains the full path of the file or folder which thumbnail image is currently displayed. Assign a value to this property to display a different thumbnail image.
	ShellControlConnector	Use this property to connect this component to a ShellControlConnector. All shell controls connected to the same ShellControlConnector will automatically synchronize the information they display. That means if a user selects a file in a ShellListView, the ThumbnailImage will automatically display the thumbnail image of the selected object.
	ShowErrorMessages	If set to true the ThumbnailImage component will show a MessageBox if an error occured, otherwise the errors will only be logged to the Debug output.
	Version	The current version of the ShellBrowser.

Top

Methods

	Name	Description
	BeginInit	Signals the object that initialization is starting.
	ClearImage	Clear the current Image.
	Dispose	Remove reference to ShellControlConnector and implicitely remove this control from the list of known controls of the ShellControlConnector (Overrides ControlDispose(Boolean).)
	EndInit	Signals the object that initialization is complete.
	FolderChanged	Gets called if the active folder should change.
	FullRefresh	Reloads the thumbnail image.
	GetThumbnailImage	This method starts generating a thumbnail asynchronously
	GoUp	Implements IShellControlIShellControl.GoUp.
	OnCreateControl	Raises the CreateControl method. (Overrides ControlOnCreateControl.)
	OnHandleCreated	Raises the HandleCreated event. (Overrides ControlOnHandleCreated(EventArgs).)
	OnPictureBoxClick	Fire the OnClick event of the panel, when the same event gets fired for the PictureBox.
	OnPictureDoubleClick	Fire the OnDoubleClick event of the panel, when the same event gets fired for the PictureBox.
	OnResize	The Resize event must be overridden, because the PictureBox class has no Align property. (Overrides PanelOnResize(EventArgs).)
	OnThumnbailLoaded	Calls the ThumbnailLoaded event
	Refresh(RefreshLevel)	This method indicates that the control should perform a refresh of its contents.
	Refresh(RefreshLevel, ItemIdList)	This method indicates that the control should perform a refresh of its contents.
	SelectedFileChange	Gets called if the active file should change.
	SmartRefresh	Implements IShellControlIShellControl.SmartRefresh. Internally calls FullRefreshFullRefresh.

Top

Events

	Name	Description
	Initialized	Occurs when initialization of the component is completed.
	ThumbnailLoaded	Event is thrown when the control has finished loading the image.

Top

Extension Methods

	Name	Description
	HandleNeeded	A Control extension method that ensures that the handle for a control is created. (Defined by ExtensionMethods.)
	ScaledPixels	An extension method for controls: It scales the passed pixels according to the current dpi the control is displayed with. (Defined by ExtensionMethods.)
	ScaleFont	A Control extension method that scales font according to the passed factor. (Defined by ExtensionMethods.)

Top

Reference

Jam.Shell Namespace