Fonction IsAccelerator (ole2.h)

Détermine si la frappe spécifiée est mappée à un accélérateur dans la table d’accélérateur spécifiée.

Syntaxe

BOOL IsAccelerator(
  [in]  HACCEL hAccel,
  [in]  int    cAccelEntries,
  [in]  LPMSG  lpMsg,
  [out] WORD   *lpwCmd
);

Paramètres

[in] hAccel

Poignée de la table d’accélérateur.

[in] cAccelEntries

Nombre d’entrées dans la table accélérateur.

[in] lpMsg

Pointeur vers le message de frappe à traduire.

[out] lpwCmd

Pointeur vers une variable pour recevoir l’identificateur de commande correspondant s’il existe un accélérateur pour la frappe. Ce paramètre peut avoir la valeur NULL.

Valeur retournée

Si le message concerne l’application objet, la valeur de retour est TRUE. Si le message ne concerne pas l’objet et doit être transféré vers le conteneur, la valeur renvoyée est FALSE.

Remarques

Bien qu’un objet soit actif sur place, l’objet a toujours la première chance de traduire les frappes en accélérateurs. Si la frappe correspond à l’un de ses accélérateurs, l’objet ne doit pas appeler la fonction OleTranslateAccelerator , même si son appel à la fonction TranslateAccelerator échoue. L’échec du traitement des frappes de cette manière peut entraîner un comportement incohérent.

Si la frappe n’est pas l’un des accélérateurs de l’objet, l’objet doit appeler OleTranslateAccelerator pour permettre au conteneur d’essayer sa traduction d’accélérateur.

Le serveur de l’objet peut appeler IsAccelerator pour déterminer si le message accélérateur lui appartient. Certains serveurs effectuent eux-mêmes la traduction d’accélérateur et n’appellent pas TranslateAccelerator. Ces applications n’appelleront pas IsAccelerator, car elles disposent déjà des informations.

Configuration requise

Voir aussi

OleTranslateAccelerator

TranslateAccelerator