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

Article
03/13/2024

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