Microsoft.WindowsAPICodePack.ShellExtensions

This interface exposes the function for initializing the Preview Handler with a . This interface can be used in conjunction with the other intialization interfaces, but only 1 will be accessed according to the priorities preset by the Windows Shell:

Provides the to the item from which a preview should be created.

Stream to the previewed file, this stream is only available in the scope of this method.

Provides the to the item from which a preview should be created.

File information to the previewed file.

Provides the from which a preview should be created.

ShellObject for the previewed file, this ShellObject is only available in the scope of this method.

This is the base class for all preview handlers and provides their basic functionality. To create a custom preview handler a class must derive from this, use the , and implement 1 or more of the following interfaces: , , .

Provides means by which to initialize with a stream.

Initializes with a stream.

Provides means by which to initialize with a ShellObject

Initializes with ShellItem

Provides means by which to initialize with a file.

Initializes with a file.

Called immediately before the preview is to be shown.

Called when the preview is no longer shown.

Called to update the bounds and position of the preview control

Called when an exception occurs during the initialization of the control

Called when the preview control obtains focus.

Called when a request is received to set or change the background color according to the user's preferences.

An int representing the ARGB color

Called when a request is received to set or change the foreground color according to the user's preferences.

An int representing the ARGB color

Called to set the font of the preview control according to the user's preferences.

Called to set the parent of the preview control.

Called when the assembly is registered via RegAsm.

Type to register.

Called when the assembly is Unregistered via RegAsm.

Type to unregister

Gets whether the preview is currently showing

This should return the window handle to be displayed in the Preview.

This class attribute is applied to a Preview Handler to specify registration parameters.

Creates a new instance of the attribute.

Name of the Handler Semi-colon-separated list of file extensions supported by the handler. A unique guid used for process isolation.

Gets the name of the handler.

Gets the semi-colon-separated list of extensions supported by the preview handler.

Gets the AppId associated with the handler for use with the surrogate host process.

Disables low integrity-level process isolation. This should be avoided as it could be a security risk.

This is the base class for all WinForms-based preview handlers and provides their basic functionality. To create a custom preview handler that contains a WinForms user control, a class must derive from this, use the , and implement 1 or more of the following interfaces: , , .

Called when an exception is thrown during itialization of the preview control.

This control must be populated by the deriving class before the preview is shown.

This is the base class for all WPF-based preview handlers and provides their basic functionality. To create a custom preview handler that contains a WPF user control, a class must derive from this, use the , and implement 1 or more of the following interfaces: , , .

Throws an exception if the Control property has not been populated.

Updates the placement of the Control.

Preview handler control finalizer

Disposes the control

Provides means to dispose the object. When overriden, it is imperative that base.Dispose(true) is called within the implementation.

This control must be populated by the deriving class before the preview is shown.

ComVisible interface for native IThumbnailProvider

Gets a pointer to a bitmap to display as a thumbnail

Class for marshaling to native LogFont struct

Font height

Font width

Font escapement

Font orientation

Font weight

Font italic

Font underline

Font strikeout

Font character set

Font out precision

Font clip precision

Font quality

Font pitch and family

Font face name

A strongly-typed resource class, for looking up localized strings, etc.

Returns the cached ResourceManager instance used by this class.

Overrides the current thread's CurrentUICulture property for all resource lookups using this strongly typed resource class.

Looks up a localized string similar to Control has not yet been assigned. Methods requiring it cannot be called..

Looks up a localized string similar to {0} must implement one or more of IPreviewFromStream, IPreviewFromShellObject or IPreviewFromFile..

Looks up a localized string similar to PreviewHandler '{0}' must have exactly one PreviewHandler attribute..

Looks up a localized string similar to Unable to call interface {0} because it is not supported on this object..

Looks up a localized string similar to The sum of offset and count must be less than or equal to the size of the buffer..

Looks up a localized string similar to Count must be greater than or equal to zero..

Looks up a localized string similar to The stream was initialized as read-only..

Looks up a localized string similar to Offset must be greater than or equal to zero..

Looks up a localized string similar to {0} does not implement IThumbnailFromStream and so requires DisableProcessIsolation set to true..

Looks up a localized string similar to {0} must implement one or more of IThumbnailFromStream, IThumbnailFromShellObject or IThumbnailFromFile..

Looks up a localized string similar to Cannot retrieve handle because proxy window has not been created..

A wrapper for the native IStream object.

Reads a single byte from the stream, moving the current position ahead by 1.

A single byte from the stream, -1 if end of stream.

Writes a single byte to the stream

Byte to write to stream

Reads a buffer worth of bytes from the stream.

Buffer to fill Offset to start filling in the buffer Number of bytes to read from the stream

Writes a buffer to the stream if able to do so.

Buffer to write Offset in buffer to start writing Number of bytes to write to the stream

Seeks within the underlying IStream.

Offset Where to start seeking

Sets the length of the stream

Commits data to be written to the stream if it is being cached.

Disposes the stream.

True if called from Dispose(), false if called from finalizer.

Gets whether the stream can be read from.

Gets whether seeking is supported by the stream.

Gets whether the stream can be written to. Always false.

Gets the length of the IStream

Gets or sets the current position within the underlying IStream.

Options for commiting (flushing) an IStream storage stream

Uses default options

Overwrite option

Only if current

Commits to disk cache dangerously

Consolidate

This interface exposes the function for initializing the Thumbnail Provider with a . If this interfaces is not used, then the handler must opt out of process isolation. This interface can be used in conjunction with the other intialization interfaces, but only 1 will be accessed according to the priorities preset by the Windows Shell:

Provides the to the item from which a thumbnail should be created. Only 32bpp bitmaps support adornments. While 24bpp bitmaps will be displayed they will not display adornments. Additional guidelines for developing thumbnails can be found at http://msdn.microsoft.com/en-us/library/cc144115(v=VS.85).aspx

Stream to initialize the thumbnail Square side dimension in which the thumbnail should fit; the thumbnail will be scaled otherwise.

This interface exposes the function for initializing the Thumbnail Provider with a . This interface can be used in conjunction with the other intialization interfaces, but only 1 will be accessed according to the priorities preset by the Windows Shell:

ShellObject to initialize the thumbnail Square side dimension in which the thumbnail should fit; the thumbnail will be scaled otherwise. Generated thumbnail

This interface exposes the function for initializing the Thumbnail Provider with file information. This interface can be used in conjunction with the other intialization interfaces, but only 1 will be accessed according to the priorities preset by the Windows Shell:

FileInfo to initialize the thumbnail Square side dimension in which the thumbnail should fit; the thumbnail will be scaled otherwise. Generated thumbnail

This is the base class for all thumbnail providers and provides their basic functionality. To create a custom thumbnail provider a class must derive from this, use the , and implement 1 or more of the following interfaces: , , .

Sets the AlphaType of the generated thumbnail. Override this method in a derived class to change the thumbnails AlphaType, default is Unknown.

ThumnbailAlphaType

Called when the assembly is registered via RegAsm.

Type to be registered.

Called when the assembly is registered via RegAsm.

Type to register.

Finalizer for the thumbnail provider.

Disposes the thumbnail provider.

Disploses the thumbnail provider.

This class attribute is applied to a Thumbnail Provider to specify registration parameters and aesthetic attributes.

Creates a new instance of the attribute.

Name of the provider Semi-colon-separated list of extensions supported by this provider.

Gets the name of the provider

Gets the semi-colon-separated list of extensions supported by the provider.

Opts-out of running within the surrogate process DllHost.exe. This will reduce robustness and security. This value should be true if the provider does not implement .

Below this size thumbnail images will not be generated - file icons will be used instead.

A resource reference string pointing to the icon to be used as an overlay on the bottom right of the thumbnail. ex. ISVComponent.dll@,-155 ex. C:\Windows\System32\SampleIcon.ico If an empty string is provided, no overlay will be used. If the property is set to null, the default icon for the associated icon will be used as an overlay.

Specifies the for the thumbnail. Only 32bpp bitmaps support adornments. While 24bpp bitmaps will be displayed, their adornments will not. If an adornment is specified by the file-type's associated application, the applications adornment will override the value specified in this registration.

Defines the minimum thumbnail size for which thumbnails will be generated.

Default size of 20x20

Size of 32x32

Size of 16x16

Size of 48x48

Size of 16x16. An alternative to Square16.

Adornment applied to thumbnails.

This will use the associated application's default icon as the adornment.

No adornment

Drop shadow adornment

Photo border adornment

Video sprocket adornment