Partager via

Méthode IPreviewHandlerFrame ::GetWindowContext (shobjidl_core.h)

  • Article

Obtient la liste des raccourcis clavier de l’hôte en préversion.

Syntaxe

HRESULT GetWindowContext(
  [out] PREVIEWHANDLERFRAMEINFO *pinfo
);

Paramètres

[out] pinfo

Type : PREVIEWHANDLERFRAMEINFO*

Pointeur vers une structure PREVIEWHANDLERFRAMEINFO qui reçoit des informations de table d’accélérateur.

Valeur retournée

Type : HRESULT

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

Remarques

Une table d’accélérateur est une liste de raccourcis clavier et des commandes que l’hôte doit exécuter. En guise d’optimisation, le gestionnaire d’aperçu peut ensuite examiner les séquences de touches qu’il reçoit, les case activée sur la table d’accélérateur pour voir si l’hôte les intéresse et les transférer le cas échéant, en ignorant les commandes dans la structure. La table d’accélérateur retournée par IPreviewHandlerFrame ::GetWindowContext contient uniquement des séquences de touches et ne contient pas d’entrées de commande valides. Les gestionnaires d’aperçu peuvent également ignorer cette optimisation et appeler simplement IPreviewHandlerFrame ::TranslateAccelerator pour chaque séquence de touches. Lorsque le gestionnaire d’aperçu est détruit, la table d’accélérateur doit être libérée à l’aide de la fonction DestroyAcceleratorTable .

Cette méthode doit être appelée au moment où le gestionnaire d’aperçu a appelé SetSite et que les résultats ont été mis en cache pour une utilisation ultérieure par le gestionnaire d’aperçu. Cette méthode ne peut pas être appelée par les gestionnaires d’aperçu s’exécutant en mode à faible intégrité. Ces gestionnaires d’aperçu doivent toujours appeler IPreviewHandlerFrame ::TranslateAccelerator pour chaque séquence de touches.

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

Voir aussi

IPreviewHandlerFrame

IPreviewHandlerFrame ::TranslateAccelerator