Rezept-Vorschauhandler (Beispiel)

Veranschaulicht, wie ein Handler geschrieben wird, mit dem eine Dateivorschau im Vorschaubereich Windows Explorer oder in anderen Vorschauhandlerhosts angezeigt wird.

Dieses Thema enthält folgende Abschnitte:

Requirements (Anforderungen)

Produkt Mindestversion des Produkts
Windows Windows Vista
Windows Software Development Kit (SDK) 7.0

Herunterladen des Beispiels

Standort Pfad-URL
GitHub RecipePreviewHandler-Beispiel

Erstellen des Beispiels

So erstellen Sie das Beispiel über die Eingabeaufforderung:

  1. Öffnen Sie das Eingabeaufforderungsfenster, und navigieren Sie zum Projektverzeichnis RecipePreviewHandler. Beispiel: C:\Program Files\MicrosoftSDKs\Windows\v7.0\Samples\WinUI\Shell\AppShellIntegration\RecipePreviewHandler.
  2. Geben Sie msbuild PreviewHandlerSDKSample.sln ein.

So erstellen Sie das Beispiel mit Microsoft Visual Studio (bevorzugt):

  1. Öffnen Sie Windows Explorer, und navigieren Sie zum Projektverzeichnis RecipePreviewHandler.

  2. Doppelklicken Sie auf das Symbol für die Datei PreviewHandlerSDKSample.sln, um das Projekt in Visual Studio zu öffnen.

    Hinweis

    Die Dateierweiterung .sln wird in den Standardordnereinstellungen nicht angezeigt. In diesem Fall kann es durch sein eindeutiges Symbol oder durch die Typbeschreibung "Microsoft Visual Studio Lösung" identifiziert werden.

  3. Klicken Sie im Menü Build (Erstellen) auf Build Solution (Projektmappe erstellen).

Hinweis

Wenn das Zielsystem 64-Bit (x64) ist, muss dieser Beispielvorschauhandler als 64-Bit-Anwendung erstellt werden.

Ausführen des Beispiels

  1. Öffnen Sie das Eingabeaufforderungsfenster, und navigieren Sie zum erstellten Projektverzeichnis RecipePreviewHandler. Beispiel: C:\Program Files\MicrosoftSDKs\Windows\v7.0\Samples\WinUI\Shell\AppShellIntegration\RecipePreviewHandler\RecipePreviewHandler. Geben Sie regsvr32.exe PreviewHandlerSDKSample.dll ein, um den Handler zu registrieren.
  2. Öffnen Sie Windows Explorer, und zeigen Sie den Vorschaubereich an, falls er noch nicht angezeigt wird.
    • Windows 7: Klicken Sie auf die Schaltfläche Vorschaubereich.
    • Windows Vista: Klicken Sie auf das Menü Organisieren, wechseln Sie zum Untermenü Layout, und wählen Sie Vorschaubereich aus.
  3. Navigieren Sie mit Windows Explorer zum Projektverzeichnis RecipePreviewHandler.
  4. Wählen Sie die Beispieldatei .recipe aus.

Damit sowohl die 32-Bit-Ausgabe (x86) als auch die 64-Bit-Ausgabe (x64) für eine 64-Bit-Version von Windows funktioniert, legen Sie den AppId-Wert auf den WOW64-Ersatzhost {534A1E02-D58F-44f0-B58B-36CBED287C7C} fest, wie im folgenden Code gezeigt.

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

Aufheben der Registrierung der DLL des Beispielvorschauhandlers

  • Öffnen Sie das Eingabeaufforderungsfenster, und geben Sie regsvr32.exe /u PreviewHandlerSDKSample.dll ein, um die Registrierung des Handlers zu aufheben.

IPreviewHandler

IPreviewHandlerFrame

Anwendungsbenutzermodell-IDs (AppUserModelIDs)