Partager via

Méthode IOleInPlaceActiveObject ::TranslateAccelerator (oleidl.h)

  • Article

Traite les messages de touche d’accélérateur de menu à partir de la file d’attente de messages du conteneur. Cette méthode doit être utilisée uniquement pour les objets créés par une application d’objet DLL.

Syntaxe

HRESULT TranslateAccelerator(
  [in] LPMSG lpmsg
);

Paramètres

[in] lpmsg

Pointeur vers une structure MSG pour le message qui doit peut-être être traduit.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour Description
S_FALSE
 Le message n’a pas été traduit.
E_INVALIDARG
 Les valeurs de paramètre spécifiées ne sont pas valides.
E_OUTOFMEMORY
 IIl n’y a pas suffisamment de mémoire disponible pour l’opération.
E_UNEXPECTED
 Une erreur inattendue s’est produite.

Remarques

Remarques aux appelants

Les objets actifs sur place doivent toujours avoir la première chance de traduire les séquences de touches d’accélérateur. Vous pouvez fournir cette opportunité en appelant IOleInPlaceActiveObject ::TranslateAccelerator à partir de la boucle de message de votre conteneur avant d’effectuer toute autre traduction. Vous devez appliquer votre propre traduction uniquement lorsque cette méthode retourne S_FALSE.

Si vous appelez IOleInPlaceActiveObject ::TranslateAccelerator pour un objet qui n’est pas créé par une application d’objet DLL, le gestionnaire d’objets par défaut retourne S_FALSE.

Remarques aux implémenteurs

Un objet créé par une application d’objet EXE obtient des séquences de touches à partir de sa propre pompe de messages, de sorte que le conteneur n’obtient pas ces messages.

Si vous devez implémenter cette méthode, vous pouvez le faire en encapsulant simplement l’appel à la fonction TranslateAccelerator .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête oleidl.h

Voir aussi

IOleInPlaceActiveObject

OleTranslateAccelerator

TranslateAccelerator