Partager via

Fonction IsAccelerator (ole2.h)

  • Article

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

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 ole2.h
Bibliothèque Ole32.lib
DLL Ole32.dll

Voir aussi

OleTranslateAccelerator

TranslateAccelerator