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:
- Anforderungen
- Herunterladen des Beispiels
- Erstellen des Beispiels
- Ausführen des Beispiels
- Aufheben der Registrierung der DLL des Beispielvorschauhandlers
- Zugehörige Themen
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:
- Öffnen Sie das Eingabeaufforderungsfenster, und navigieren Sie zum Projektverzeichnis RecipePreviewHandler. Beispiel:
C:\Program Files\MicrosoftSDKs\Windows\v7.0\Samples\WinUI\Shell\AppShellIntegration\RecipePreviewHandler. - Geben Sie
msbuild PreviewHandlerSDKSample.slnein.
So erstellen Sie das Beispiel mit Microsoft Visual Studio (bevorzugt):
Öffnen Sie Windows Explorer, und navigieren Sie zum Projektverzeichnis RecipePreviewHandler.
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.
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
- Ö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 Sieregsvr32.exe PreviewHandlerSDKSample.dllein, um den Handler zu registrieren. - Ö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.
- Navigieren Sie mit Windows Explorer zum Projektverzeichnis RecipePreviewHandler.
- 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.dllein, um die Registrierung des Handlers zu aufheben.