配方预览控件示例

演示如何编写用于在 Windows 资源管理器预览窗格或其他预览处理程序主机内显示文件预览的处理程序。

本主题包含以下各节：

要求

产品	最低产品版本
Windows	Windows Vista
Windows 软件开发包 (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 解决方案”来标识它。
从“构建”菜单中，选择“构建解决方案”。

注意

如果目标系统是 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}"}