IsAccelerator 函数 (ole2.h)

  • 项目

确定指定的击键是否映射到指定快捷键表中的快捷键。

语法

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

参数

[in] hAccel

快捷键表的句柄。

[in] cAccelEntries

快捷键表中的条目数。

[in] lpMsg

指向要转换的击键消息的指针。

[out] lpwCmd

指向变量的指针，用于在有快捷键的情况下接收相应的命令标识符。 此参数可以为 NULL。

返回值

如果消息针对对象应用程序，则返回值为 TRUE。 如果消息不是针对 对象且应转发到容器，则返回值为 FALSE。

注解

当对象就地处于活动状态时，对象始终第一次有机会将击键转换为加速键。 如果击键对应于其加速键之一，则对象不得调用 OleTranslateAccelerator 函数 - 即使它对 TranslateAccelerator 函数的调用失败也是如此。 未能以这种方式处理击键可能会导致不一致的行为。

如果击键不是对象的加速键之一，则对象必须调用 OleTranslateAccelerator ，让容器尝试其加速键转换。

对象的服务器可以调用 IsAccelerator 来确定加速器消息是否属于它。 某些服务器自行执行加速器转换，不调用 TranslateAccelerator。 这些应用程序不会调用 IsAccelerator，因为它们已具有信息。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ole2.h
Library Ole32.lib
DLL Ole32.dll

另请参阅

OleTranslateAccelerator

TranslateAccelerator