IPreviewHandler::SetWindow-Methode (shobjidl_core.h)

  • Artikel

Legt das übergeordnete Fenster des Vorschaufensters sowie den Bereich innerhalb des übergeordneten Fensters fest, der für das Vorschaufenster verwendet werden soll.

Syntax

HRESULT SetWindow(
  [in] HWND       hwnd,
  [in] const RECT *prc
);

Parameter

[in] hwnd

Typ: HWND

Ein Handle für das übergeordnete Fenster.

[in] prc

Typ: const RECT*

Ein Zeiger auf ein RECT , das den Bereich für die Vorschau definiert.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Vorschauhandler ist für das Zeichnen des gesamten von prc definierten Bereichs verantwortlich. Wenn das Vorschaufenster erstellt wurde, muss der Vorschauhandler das Vorschaufenster dem neuen übergeordneten hwnd zuordnen und die Größe des Vorschaufensters dem von prc definierten Bereich anpassen. Wenn das Vorschaufenster noch nicht erstellt wurde, muss sich der Vorschauhandler diese Informationen merken, wenn das Vorschaufenster in IPreviewHandler::D oPreview erstellt wird.

Hinweis Es wird empfohlen, diese Informationen vor dem Aufrufen von IPreviewHandler::D oPreview zu speichern. Dies erhöht die Leistung zur Einrichtungszeit für alle Fälle, in denen die Vorschau nicht gestartet wird.
 

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 (einschließlich Shobjidl.h)
Verteilbare Komponente Windows Search 4 oder höher