File Preview Dialog Class

Many times you may want to allow your users to see a preview of the file
that they are about to open. CPreviewFileDialog does just that.

The only work that you will have to do is to write a class derived
from CAbstractPreview . Two functions will have to be implemented in this
class.

SetPreviewFile(const CString& csFileName) –
This function is called each time the user changes his selection.
This method allows you to open the file and get things ready for painting it
in the Open File Dialog ( and yes , you can use it for a save Dialog also).

Keep in mind that the file name passed may not be a valid one.
For example, if the user chooses a directory, you will get the name of the
directory. It is upto you to decide how you want this case handled.

DrawPreview(CDC *pDC,int x,int y,int width,int height) –
This routine will be called to actually paint the image. The
DC which is sent is not clipped. You will have to make sure that you
keep within the bounds. The preview is shown on the right hand side
of the window. By default, the width and height of the preview window
are 100 bytes. You may want to draw on a smaller scale . Or, more often
, you may have to scale your view to the smallest fitting rectangle.
You can call the routine Calc for this. Pass it the width and height
of your original view and the window width and height passed to you.
You will get a CRect which centres your view.

One more small thing ! The sample project contains a dialog called
“FILEOPEN_TEMPLATE”. You will have to copy this into your project
resource file.

Also , please do not forget to include CPreviewFileDialog.cpp in
your project. I`m aware that the file name has an extra C prefixed,
but I had to rename it as it was conflicting with some of my older
projects which are in the include path.

In every other way, use CPreviewFileDialog exactly as you would
CFileDialog. Just pass its constructor a pointer to a class derived
from CAbstractPreview.

CPreviewFileDialg also provides a checkbox the user can use to
disable the preview feature.

The files to look at in the sample are CTestPreviewDoc – take a look at OnFileOpen…

I have used a support class called CDIB to handle Device Independent
Bitmaps. You are free to use it , but let me warn you , no comments
in the code and no formal help from me. Be warned also, that it is meant
primarily for 8 bit bitmaps. If you have a doubt ,
mail me [email protected] and I`ll try to help.

Have a look at the sample and happy previewing.

Downloads

Download demo project – 30 Kb

Download source – 2 Kb

History

More by Author

Must Read