Click or drag to resize

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

Namespace:  Jam.Shell
Assembly:  ShellBrowser (in ShellBrowser.dll) Version: 6.2
Syntax
public class ThumbnailImage : Panel, 
	IShellControl, IShellControlConnectorTarget, ISupportInitialize, ISupportInitializeNotification

The ThumbnailImage type exposes the following members.

Constructors
  NameDescription
Public methodThumbnailImage
Initializes a new instance of the ThumbnailImage class.
Top
Properties
  NameDescription
Public propertyEnabled
Indicates whether the control is enabled.
Public propertyIconsAsThumnbnails
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.
Public propertyImage
Readonly property, which contains the currently shown thumbnail image.
Protected propertyImageHeight
Gets the height of the image.
Protected propertyImageWidth
Returns the width that is used for the image.
Public propertyIsInitialized
Gets a value indicating whether the component is initialized.
Public propertyPath
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.
Public propertyShellControlConnector
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.
Public propertyShowErrorMessages
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.
Public propertyVersion
The current version of the ShellBrowser.
Top
Methods
  NameDescription
Public methodBeginInit
Signals the object that initialization is starting.
Public methodClearImage
Clear the current Image.
Protected methodDispose
Remove reference to ShellControlConnector and implicitely remove this control from the list of known controls of the ShellControlConnector
(Overrides ControlDispose(Boolean).)
Public methodEndInit
Signals the object that initialization is complete.
Public methodFolderChanged
Gets called if the active folder should change.
Public methodFullRefresh
Reloads the thumbnail image.
Protected methodGetThumbnailImage
This method starts generating a thumbnail asynchronously
Public methodGoUp
Implements IShellControlIShellControl.GoUp.
Protected methodOnHandleCreated
Raises the HandleCreated event.
(Overrides ControlOnHandleCreated(EventArgs).)
Protected methodOnPictureBoxClick
Fire the OnClick event of the panel, when the same event gets fired for the PictureBox.
Protected methodOnPictureDoubleClick
Fire the OnDoubleClick event of the panel, when the same event gets fired for the PictureBox.
Protected methodOnResize
The Resize event must be overridden, because the PictureBox class has no Align property.
(Overrides PanelOnResize(EventArgs).)
Protected methodOnThumnbailLoaded
Calls the ThumbnailLoaded event
Public methodRefresh(RefreshLevel)
This method indicates that the control should perform a refresh of its contents.
Public methodRefresh(RefreshLevel, ItemIdList)
This method indicates that the control should perform a refresh of its contents.
Public methodSelectedFileChange
Gets called if the active file should change.
Public methodSmartRefresh
Implements IShellControlIShellControl.SmartRefresh. Internally calls FullRefreshFullRefresh.
Top
Events
  NameDescription
Public eventInitialized
Occurs when initialization of the component is completed.
Public eventThumbnailLoaded
Event is thrown when the control has finished loading the image.
Top
Extension Methods
  NameDescription
Public Extension MethodHandleNeeded
A Control extension method that ensures that the handle for a control is created.
(Defined by ExtensionMethods.)
Public Extension MethodScaledPixels
An extension method for controls: It scales the passed pixels according to the current dpi the control is displayed with.
(Defined by ExtensionMethods.)
Public Extension MethodScaleFont
A Control extension method that scales font according to the passed factor.
(Defined by ExtensionMethods.)
Top
See Also