Partager via


IPreviewHandler ::D oPreview, méthode (shobjidl_core.h)

Dirige le gestionnaire d’aperçu pour charger des données à partir de la source spécifiée dans un appel de méthode Initialize antérieur et commencer le rendu dans la fenêtre de l’aperçu.

Syntaxe

HRESULT DoPreview();

Valeur de retour

Type : HRESULT

Cette méthode peut retourner l’une de ces valeurs.

Retourner le code Description
S_OK
L’opération s’est terminée avec succès.
E_PREVIEWHANDLER_DRM_FAIL
Bloqué par la gestion des droits numériques.
E_PREVIEWHANDLER_NOAUTH
Bloqué par des autorisations de fichier.
E_PREVIEWHANDLER_NOTFOUND
L’élément est introuvable.
E_PREVIEWHANDLER_CORRUPT
L’élément a été endommagé.

Remarques

Si la fenêtre de l’aperçu n’a pas encore été créée, elle doit être créée une fois cette méthode appelée. Le gestionnaire d’aperçu est chargé de peindre la zone spécifiée dans IPreviewHandler ::SetWindow ou IPreviewHandler ::SetRect. Si ces méthodes sont appelées pendant le rendu du gestionnaire d’aperçu, la fenêtre doit être réparentée/redimensionnée sans arrêter ou redémarrer le rendu de l’élément.

Cette méthode doit être appelée uniquement après IPreviewHandler ::SetWindow a été appelée.

En outre, cette méthode doit être appelée uniquement après IInitializeWithItem ::Initialize, IInitializeWithStream ::Initializeou IInitializeWithFile ::Initialize a été appelée.

Remarque Ne créez pas réellement la fenêtre de l’aperçu tant que cette méthode n’a pas été appelée.
 

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête shobjidl_core.h (include Shobjidl.h)
redistribuable Windows Search 4 ou version ultérieure