Click here to Skip to main content
15,850,917 members
Articles / Programming Languages / C#

Photoshop Preview Handler for Windows Vista

Rate me:
Please Sign up or sign in to vote.
4.92/5 (80 votes)
4 Apr 20076 min read 356.5K   4.2K   92   90
Preview Adobe Photoshop® (PSD) files with the help of Photoshop Preview Handler and Managed Preview Handler Framework in Windows Vista™
Screenshot - PreviewHandler.jpg


Preview handler is the latest methodology in Microsoft Windows Vista™, which provide a rich, interactive, and read-only preview of a file without having to launch the associated application. The in-place interactive previews of the file are available in the Explorer windows, common dialogs, and search results. The core feature is integrated into Windows Vista Shell which allows developers to extend this functionality by writing managed code add-ins i.e. preview handlers for custom files.

For example, "a Microsoft Word 2007 Preview Handler" will enable a user to view and interact with a Microsoft Word 2007 document (.docx file) without having to launch Microsoft Word 2007. In fact, you don't even need Microsoft Word 2007 or Office 2007 to see the preview if you have the related preview handler - now that's amazing.

This article describes a preview handler for Adobe Photoshop® (PSD) file. Here is how the preview of a PSD file will look like in the preview pane

Screenshot - VistaPreview.jpg

The goal

When the user clicks on a Photoshop file (vista_adobe.psd) in the Windows Explorer

  • A "readonly" preview of the file will be shown in the preview pane
  • Image "Dimension" and "number of layers" in the PSD file will be shown in the "tooltip"
  • Resolution, Color Depth, & Compression information of the file will be available to the user

All this occurs without the Adobe Photoshop application.


Managed Preview Handler Framework

The preview handler described here uses a Managed Preview Handler Framework MsdnMagPreviewHandlers.dll which was first described by Stephen Toub here. For those of you who want to jump in and view the preview handler in action, you can download the first zip file containing the framework, as well as Photoshop Preview Handler, and follow the ReadMe.txt (included). Here is the overview:

Screenshot - prevframework.jpg

New Shell Interfaces for Windows Vista

An extensive set of COM interfaces have been added to the Shell in Windows Vista™ and greatly extend its built-in capabilities. These interfaces offer such features as: new interfaces that expose functionalities that exist in previous versions of Windows but were not exposed by the shell (such as common file dialogs), and interfaces for new Vista UI components or operating system functionality such as Known Folders, Dynamic Autoplay, and property and preview handlers. Download the complete list in the form of help file here

The following is a list of the new interfaces added to the Shell in Windows Vista to provide methods to work with preview handlers.

  • IPreviewHandler
  • IPreviewHandlerFrame
  • IPreviewHandlerVisuals
  • IPreviewHostSurrogateClient
  • IPreviewHostSurrogateSink

Making of the Photoshop Preview Handler

The whole project can be divided into three parts:

  1. The Managed Preview Handler Framework
  2. The Photoshop Preview Handler
  3. The functionality of Photoshop file Parsing

The Managed Preview Handler Framework

Here are the parts of the class diagram, which is of immediate concern for us. More details can be found in Stephen Toub's article

Screenshot - PreviewHandlerClassdiagram.jpg

Preview Handler attribute

Screenshot - PreviewHandlerClassdiagram.jpg

So what we do is create a class file in managed code and inherit it from the framework as follows:

public sealed class PhotoshopPreviewHandler : FileBasedPreviewHandler

The Photoshop Preview Handler

Screenshot - PSDPreviewHandler.jpg

Using the code

Here is the brief code which gives a bird's eye view of the preview handlers load function. For those of you who want to create a Preview Handler, I will suggest this brilliant screencast by Daniel Moth here . In fact everything you see here I did step by step as shown by Daniel from scratch.

public sealed class PhotoshopPreviewHandler : FileBasedPreviewHandler
    protected override PreviewHandlerControl CreatePreviewHandlerControl()
            return new PhotoshopPreviewHandlerControl();

private sealed class PSDPreviewHandlerControl:FileBasedPreviewHandlerControl
    public override void Load(FileInfo file)
        FileInfo mypsdfile = MakeTemporaryCopy(file);

        CPSD psd = new CPSD();
        Label label1 = new Label();
        PictureBox pictureBox1 = new PictureBox();
        pictureBox1.BorderStyle = BorderStyle.FixedSingle;
        pictureBox1.SizeMode = PictureBoxSizeMode.AutoSize;
        int nResult = psd.Load(mypsdfile.FullName);
        myToolTip.SetToolTip(pictureBox1, label1.Text);

If there is an error while parsing the Photoshop file, we have to safely show an error image and not the exception. If you want to test this, create a text file and change the extension to .psd and see the preview pane when that file is selected.

Screenshot - errorsmall.jpg

Photoshop File Parsing

Well, now comes the tricky part parsing the Photoshop file. A Photoshop file is just like a binary file with all the information as a mixture of XML and binary data. The first challenge is to get the file format specification because Adobe does not provide that freely. You have to do a request for Photoshop SDK here as well as a separate request for Photoshop File format. The good news is the Photoshop file format has not changed much since version 3.0, so if you get a copy of an old Photoshop file format, you pretty much have the stuff you need. You can also find an old version of the Photoshop File format here.

The following image gives you a glimpse of how it looks.

Screenshot - fileformat.jpg

This is the basic format of how data and information is stored in a PSD file

A file header will give you all the image related information as shown

Screenshot - FileHeader.jpg

Image resource block is one of the basic units of the PSD file

Screenshot - ImageResourceBlock.jpg

This is how data is stored in the Photoshop file; to extract it is another story. When I started my binary data reader object, I came across these excellent articles by ihaml here and Igor Tolmachev here. These articles saved me the time it might take to reinvent the wheel (reinforcing my initial idea of time saving), though I also enhanced their work to get the information of number of layers in the Photoshop file and interact with the way needed by the preview handler.

Here is the code to read the PSD File header as shown (File header image above)

protected bool ReadHeader(FileStream stream)
    bool bSuccess = false;
    BinaryReader binReader = new BinaryReader(stream);
        // Set Position to the beginning of the stream.
        binReader.BaseStream.Position = 0;
        byte [] Signature  = binReader.ReadBytes(4); // always equal 8BPS,
        byte [] Version    = binReader.ReadBytes(2); // always equal 1, do 
                                                     // not read
        byte [] Reserved   = binReader.ReadBytes(6); // must be zero
        byte [] Channels   = binReader.ReadBytes(2); // number of channels 
                                                     // 1 to 24
        byte [] Rows       = binReader.ReadBytes(4); // height in PIXELS,
        byte [] Columns    = binReader.ReadBytes(4); // width in PIXELS,
        byte [] Depth      = binReader.ReadBytes(2); // number of bpp
        byte [] Mode       = binReader.ReadBytes(2); // colour mode of the 
                                                     // file
        // Btmap=0, Grayscale=1, Indexed=2, RGB=3,
        // CMYK=4, Multichannel=7, Duotone=8, Lab=9
        ASCIIEncoding encoding = new ASCIIEncoding();

So you create a Photoshop parser, return the file information in a Photoshop Preview handler, which, utilizing the preview handler framework, shows you the image data information for the preview pane.

Points of Interest

  • During the development of preview handlers, if you don't see the changes (even after using reinstall.bat) a PC restart solves the problem of detaching the existing version of the preview handler dll and the framework from GAC.
  • If you want to create your own preview handler look closely the implementation of MakeTemporaryCopy(file)
  • Will add more as I come across, adios

Photoshop Preview Handler in action for Outlook 2007

Screenshot - OutlookPreview.jpg

Some concluding thoughts

Almost all software applications in the world are developed with at least one purpose in mind: "saving time". Be it a Windows application, a Java applet, a shell script, tiny applications hosted in sidebar gadget, a search engine, an e-commerce application, a tic tac toe game (yes! even a simple game), all the projects, products, api's, solutions, services, everything which has been developed for the purpose of saving time. Think about it, software which saves more time is better software. This is one of the reasons why Preview Handlers will be very popular.


Article History

  • Mar 29, 2007: First published
  • Apr 01, 2007: Content revised

And thanks

For coming so far! I hope you find this as useful as I do, and take care.


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Written By
Founder Teamcal AI
United States United States

Comments and Discussions

Questiondoes this work for windows 8 Pin
Sisneh K8-Jan-13 20:05
Sisneh K8-Jan-13 20:05 
GeneralMy vote of 5 Pin
rickz658-Apr-11 0:02
rickz658-Apr-11 0:02 
GeneralRe: My vote of 5 Pin
Raj Lal2-Dec-11 3:49
professionalRaj Lal2-Dec-11 3:49 
AnswerWorks with Windows 7 (x64) with CS5 Pin
Justincc27-Jul-10 20:43
professionalJustincc27-Jul-10 20:43 
AnswerRe: Works with Windows 7 (x64) with CS5 Pin
sascha jazbec21-Oct-10 18:05
sascha jazbec21-Oct-10 18:05 
Questionhow to create a column preview handler Pin
Sebastian Sosna29-Mar-10 23:04
Sebastian Sosna29-Mar-10 23:04 
Generalawesum Idea Pin
blober7-Dec-09 6:32
blober7-Dec-09 6:32 
Raj Lal22-Oct-10 13:24
professionalRaj Lal22-Oct-10 13:24 
jimmiem31-Oct-10 11:56
jimmiem31-Oct-10 11:56 
GeneralPS preview handler Pin
rodisava31-Jul-09 1:27
rodisava31-Jul-09 1:27 
QuestionTrying to install this Pin
zack620004-Jun-09 17:04
zack620004-Jun-09 17:04 
AnswerRe: Trying to install this Pin
Nasenbaaer10-Jun-09 22:37
Nasenbaaer10-Jun-09 22:37 
GeneralCS3 support Pin
sharper_121-Jan-09 18:27
sharper_121-Jan-09 18:27 
Questionfailure adding assembly... Pin
pipiaa98013-Oct-08 2:11
pipiaa98013-Oct-08 2:11 
AnswerRe: failure adding assembly... Pin
Derek Loewen2-May-09 18:00
Derek Loewen2-May-09 18:00 
Questionunable to install Pin
simontull10-Oct-08 3:24
simontull10-Oct-08 3:24 
AnswerRe: unable to install Pin
Raj Lal10-Oct-08 10:47
professionalRaj Lal10-Oct-08 10:47 
AnswerRe: unable to install Pin
simontull14-Oct-08 6:50
simontull14-Oct-08 6:50 
GeneralInstall Photoshop Preview Handler Pin
Phillip Gordon9-Oct-08 15:56
Phillip Gordon9-Oct-08 15:56 
GeneralRe: Install Photoshop Preview Handler Pin
Raj Lal10-Oct-08 10:48
professionalRaj Lal10-Oct-08 10:48 
GeneralRe: Install Photoshop Preview Handler Pin
Phillip Gordon11-Oct-08 0:32
Phillip Gordon11-Oct-08 0:32 
GeneralRe: Install Photoshop Preview Handler Pin
Raj Lal12-Oct-08 10:43
professionalRaj Lal12-Oct-08 10:43 
GeneralThank you! Pin
m.mishka5-Sep-08 10:20
m.mishka5-Sep-08 10:20 
GeneralRe: Thank you! Pin
Raj Lal10-Oct-08 10:48
professionalRaj Lal10-Oct-08 10:48 
GeneralThis is Excellent work! Pin
paragme1-Aug-08 19:42
paragme1-Aug-08 19:42 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.