IPreviewHandler ::SetWindow, méthode (shobjidl_core.h)

Article
03/04/2024

Définit la fenêtre parente de la fenêtre d’aperçu, ainsi que la zone dans le parent à utiliser pour la fenêtre d’aperçu.

Syntaxe

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

Paramètres

[in] hwnd

Type : HWND

Handle de la fenêtre parente.

[in] prc

Type : const RECT*

Pointeur vers un RECT définissant la zone de l’aperçu.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le gestionnaire d’aperçu est chargé de peindre la zone entière définie par prc. Si la fenêtre d’aperçu a été créée, le gestionnaire d’aperçu doit associer la fenêtre d’aperçu au nouveau hwnd parent et redimensionner la fenêtre d’aperçu sur la zone définie par prc. Si la fenêtre d’aperçu n’a pas encore été créée, le gestionnaire d’aperçu doit mémoriser ces informations lorsque la fenêtre d’aperçu est créée dans IPreviewHandler ::D oPreview.

Note Il est préférable que ces informations soient stockées avant d’appeler IPreviewHandler ::D oPreview. Cela augmente les performances au moment de l’installation pour tous les cas où la préversion ne démarre pas.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)
Composant redistribuable	Windows Search 4 ou version ultérieure

Partager via