IPreviewHandler-Schnittstelle (shobjidl_core.h)

Macht Methoden für die Anzeige umfangreicher Vorschauen verfügbar.

Vererbung

Die IPreviewHandler-Schnittstelle erbt von der IUnknown-Schnittstelle . IPreviewHandler verfügt auch über die folgenden Typen von Membern:

Methoden

Die IPreviewHandler-Schnittstelle verfügt über diese Methoden.

IPreviewHandler::D oPreview Weist den Vorschauhandler an, Daten aus der Quelle zu laden, die in einem früheren Aufruf der Initialize-Methode angegeben wurde, und mit dem Rendern im Vorschaufenster zu beginnen.
IPreviewHandler::QueryFocus Weist den Vorschauhandler an, den HWND vom Aufrufen der GetFocus-Funktion zurückzugeben.
IPreviewHandler::SetFocus Weist den Vorschauhandler an, den Fokus auf sich selbst festzulegen.
IPreviewHandler::SetRect Weist den Vorschauhandler an, den Bereich innerhalb des übergeordneten Hwnds zu ändern, in den er ein zeichnet.
IPreviewHandler::SetWindow Legt das übergeordnete Fenster des Vorschaufensters sowie den Bereich innerhalb des übergeordneten Fensters fest, der für das Vorschaufenster verwendet werden soll.
IPreviewHandler::TranslateAccelerator Weist den Vorschauhandler an, eine Tastatureingabe zu behandeln, die von der Nachrichtenpumpe des Prozesses, in dem der Vorschauhandler ausgeführt wird, übergeben wurde.
IPreviewHandler::Unload Weist den Vorschauhandler an, das Rendern einer Vorschau zu beenden und alle Ressourcen freizugeben, die basierend auf dem element zugewiesen wurden, das während der Initialisierung übergeben wurde.

Hinweise

Vorschauhandler können in verwaltetem Code erstellt werden. In der Regel werden alle Vorschauhandler zusammen in einem Ersatzprozess namens prevhost.exe gehostet. Es gibt einen instance dieses Prozesses für Vorschauhandler, die auf normaler Integritätsebene ausgeführt werden, und ein weiterer instance für Vorschauhandler, die mit niedriger Integritätsebene ausgeführt werden. Wenn Sie Ihren Handler in verwaltetem Code implementieren möchten, sollte Ihr Handler nicht in einem dieser freigegebenen Prozesse ausgeführt werden. Veranlassen Sie stattdessen, dass Ihr Handler eine neue instance von prevhost.exe erhält, indem Sie einen neuen AppID-Eintrag in der Registrierung erstellen (prevhost.exe als DllSurrogate-Wert angeben) und dann als AppID-Wert im Registrierungswert für die Klassen-ID Ihres Handlers festlegen. Dadurch wird sichergestellt, dass eine eindeutige prevhost.exe instance für Ihren Handler erstellt wird, anstelle der gängigen Instanzen, die von den anderen Handlern verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h
Verteilbare Komponente	Windows Search 4 oder höher