Edit

Recipe Preview Handler Sample

  • Article

Demonstrates how to write a handler used to display a file preview inside the Windows Explorer preview pane or other preview handler hosts.

This topic contains the following sections:

Requirements

Product Minimum Product Version
Windows Windows Vista
Windows Software Development Kit (SDK) 7.0

 

Downloading the Sample

Location Path URL
GitHub RecipePreviewHandler sample

Building the Sample

To build the sample from the command prompt:

  1. Open the command prompt window and navigate to the RecipePreviewHandler project directory. For example, C:\Program Files\MicrosoftSDKs\Windows\v7.0\Samples\WinUI\Shell\AppShellIntegration\RecipePreviewHandler.
  2. Enter msbuild PreviewHandlerSDKSample.sln.

To build the sample using Microsoft Visual Studio (preferred):

  1. Open Windows Explorer and navigate to the RecipePreviewHandler project directory.

  2. Double-click the icon for the PreviewHandlerSDKSample.sln file to open the project in Visual Studio.

    Note

    The .sln file name extension is not shown under default folder settings. In that situation, it can be identified by its unique icon or by its type description "Microsoft Visual Studio Solution".

     

  3. From the Build menu, select Build Solution.

Note

If the target system is 64-bit (x64), this sample preview handler must be built as a 64-bit application.

 

Running the Sample

  1. Open the command prompt window and navigate to the built RecipePreviewHandler project directory. For example, C:\Program Files\MicrosoftSDKs\Windows\v7.0\Samples\WinUI\Shell\AppShellIntegration\RecipePreviewHandler\RecipePreviewHandler. Enter regsvr32.exe PreviewHandlerSDKSample.dll to register the handler.
  2. Open Windows Explorer and show the preview pane if it is not already displayed.
    • Windows 7: Click the preview pane button.
    • Windows Vista: Click the Organize menu, go to the Layout submenu and select Preview Pane.
  3. Use Windows Explorer to navigate to the RecipePreviewHandler project directory.
  4. Select the example .recipe file.

To make both the 32-bit (x86) and 64-bit (x64) output work on a 64-bit version of Windows, set the AppId value to the WOW64 surrogate host {534A1E02-D58F-44f0-B58B-36CBED287C7C}, as shown in the following code.

{HKEY_CURRENT_USER,   
 L"Software\\Classes\\CLSID\\" SZ_CLSID_RecipePreviewHandler,
 L"AppID",
 L"{534A1E02-D58F-44f0-B58B-36CBED287C7C}"}

Unregistering the Sample Preview Handler DLL

  • Open the command prompt window and enter regsvr32.exe /u PreviewHandlerSDKSample.dll to unregister the handler.

IPreviewHandler

IPreviewHandlerFrame

Application User Model IDs (AppUserModelIDs)