Interface IPreviewHandler (shobjidl_core.h)

Expose les méthodes pour l’affichage des aperçus enrichis.

Héritage

L’interface IPreviewHandler hérite de l’interface IUnknown. IPreviewHandler a également les types de membres suivants :

Méthodes

L’interface IPreviewHandler comporte ces méthodes.

IPreviewHandler ::D oPreview Indique au gestionnaire d’aperçu de charger des données à partir de la source spécifiée dans un appel de méthode Initialize antérieur et de commencer le rendu dans la fenêtre de l’aperçu.
IPreviewHandler ::QueryFocus Indique au gestionnaire d’aperçu de renvoyer le HWND d’appeler la fonction GetFocus.
IPreviewHandler ::SetFocus Indique au gestionnaire d’aperçu de définir le focus sur lui-même.
IPreviewHandler ::SetRect Indique au gestionnaire d’aperçu de modifier la zone dans le hwnd parent dans lequel il s’inscrit.
IPreviewHandler ::SetWindow 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.
IPreviewHandler ::TranslateAccelerator Indique au gestionnaire d’aperçu de gérer une frappe transmise à partir de la pompe de messages du processus dans lequel le gestionnaire d’aperçu est en cours d’exécution.
IPreviewHandler ::Unload Demande au gestionnaire d’aperçu de cesser d’afficher une préversion et de libérer toutes les ressources qui ont été allouées en fonction de l’élément transmis lors de l’initialisation.

Remarques

Les gestionnaires en préversion peuvent être intégrés dans du code managé. En règle générale, tous les gestionnaires de préversion sont hébergés ensemble dans un processus de substitution appelé prevhost.exe. Il existe un instance de ce processus pour les gestionnaires d’aperçu s’exécutant au niveau d’intégrité normal, et un autre instance pour les gestionnaires d’aperçu s’exécutant à un niveau d’intégrité faible. Si vous souhaitez implémenter votre gestionnaire dans du code managé, votre gestionnaire ne doit pas s’exécuter à l’intérieur de l’un de ces processus partagés. Au lieu de cela, organisez votre gestionnaire pour obtenir une nouvelle instance de prevhost.exe en créant une entrée AppID dans le Registre (en spécifiant prevhost.exe comme valeur DllSurrogate), puis en la définissant comme valeur AppID dans la valeur de Registre pour l’ID de classe de votre gestionnaire. Cela garantit qu’une prevhost.exe instance unique est créée pour votre gestionnaire, au lieu des instances courantes utilisées par les autres gestionnaires.

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
Composant redistribuable	Windows Search 4 ou version ultérieure