Méthode IPreviewHandlerFrame ::GetWindowContext (shobjidl_core.h)
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 |