Freigeben über

IPreviewHandler::D oPreview-Methode (shobjidl_core.h)

  • Artikel

Leitet den Vorschauhandler an, Daten aus der Quelle zu laden, die in einem früheren Initialize-Methodenaufruf angegeben wurde, und um mit dem Rendern im Vorschaufenster zu beginnen.

Syntax

HRESULT DoPreview();

Rückgabewert

Typ: HRESULT-

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK
 Der Vorgang wurde erfolgreich abgeschlossen.
E_PREVIEWHANDLER_DRM_FAIL
 Blockiert durch die Verwaltung digitaler Rechte.
E_PREVIEWHANDLER_NOAUTH
 Blockiert durch Dateiberechtigungen.
E_PREVIEWHANDLER_NOTFOUND
 Das Element wurde nicht gefunden.
E_PREVIEWHANDLER_CORRUPT
 Das Element war beschädigt.

Bemerkungen

Wenn das Vorschaufenster noch nicht erstellt wurde, muss es erstellt werden, nachdem diese Methode aufgerufen wurde. Der Vorschauhandler ist dafür verantwortlich, den in IPreviewHandler::SetWindow oder IPreviewHandler::SetRectangegebenen Bereich zu zeichnen. Wenn diese Methoden aufgerufen werden, während der Vorschauhandler gerendert wird, muss das Fenster neu analysiert/geändert werden, ohne das Rendern des Elements zu beenden oder neu zu starten.

Diese Methode sollte erst aufgerufen werden, nachdem IPreviewHandler::SetWindow aufgerufen wurde.

Darüber hinaus sollte diese Methode erst aufgerufen werden, nachdem IInitializeWithItem::Initialize, IInitializeWithStream::Initializeoder IInitializeWithFile::Initialize aufgerufen wurde.

Hinweis Erstellen Sie das Vorschaufenster erst, wenn diese Methode aufgerufen wurde.
 

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- shobjidl_core.h (include Shobjidl.h)
redistributable Windows Search 4 oder höher