配方預覽處理常式範例

示範如何撰寫處理常式，以在 Windows 檔案總管預覽窗格或其他預覽處理常式主機內顯示檔案預覽。

本主題包含下列幾節：

規格需求

產品	最低產品版本
Windows	Windows Vista
Windows Software Development Kit (SDK)	7.0

位置	路徑 URL
GitHub	RecipePreviewHandler 範例

若要從命令提示字元建置範例：

開啟命令提示字元視窗，並流覽至 RecipePreviewHandler 專案目錄。例如： C:\Program Files\MicrosoftSDKs\Windows\v7.0\Samples\WinUI\Shell\AppShellIntegration\RecipePreviewHandler 。
輸入 msbuild PreviewHandlerSDKSample.sln。

若要使用 Microsoft Visual Studio 建置範例 (慣用) ：

開啟 Windows 檔案總管並流覽至 RecipePreviewHandler 專案目錄。
按兩下 PreviewHandlerSDKSample.sln 檔案的圖示，以在 Visual Studio 中開啟專案。

注意

預設資料夾設定下不會顯示 .sln 副檔名。在此情況下，可以透過其唯一圖示或其類型描述「Microsoft Visual Studio Solution」來識別。
從 [建置] 功能表中，選取 [建置解決方案]。

注意

如果目標系統是 64 位 (x64) ，此範例預覽處理常式必須建置為 64 位應用程式。

開啟命令提示字元視窗，並流覽至建置的 RecipePreviewHandler 專案目錄。例如： C:\Program Files\MicrosoftSDKs\Windows\v7.0\Samples\WinUI\Shell\AppShellIntegration\RecipePreviewHandler\RecipePreviewHandler 。輸入 regsvr32.exe PreviewHandlerSDKSample.dll 以註冊處理常式。
開啟 Windows 檔案總管，並在尚未顯示時顯示預覽窗格。
- Windows 7：按一下 [預覽] 窗格按鈕。
- Windows Vista：按一下 [ 組織] 功能表，移至 [ 版面配置 ] 子功能表，然後選取 [預覽窗格]。
使用 Windows 檔案總管流覽至 RecipePreviewHandler 專案目錄。
選取範例 .recipe 檔案。

若要讓 32 位 (x86) 和 64 位 (x64) 輸出在 64 位版本的 Windows 上運作，請將 AppId 值設定為 WOW64 代理主機 {534A1E02-D58F-44f0-B58B-36CBED287C7C} ，如下列程式碼所示。

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