iTfKeystrokeMgr：:P reserveKey 方法 (msctf.h)

  • 项目

注册保留的密钥。

语法

HRESULT PreserveKey(
  [in] TfClientId            tid,
  [in] REFGUID               rguid,
  [in] const TF_PRESERVEDKEY *prekey,
  [in] const WCHAR           *pchDesc,
  [in] ULONG                 cchDesc
);

parameters

[in] tid

包含 TSF 文本服务的客户端标识符。 此值在其 ITfTextInputProcessor：：Activate 方法中传递给 TSF 文本服务。

[in] rguid

包含保留密钥的命令 GUID。 此值将传递给 TSF 文本服务 ITfKeyEventSink：：OnPreservedKey 方法，以在激活保留密钥时标识保留的密钥。

[in] prekey

指向 TF_PRESERVEDKEY 结构的指针，该结构指定保留的键。 uVKey 成员包含虚拟密钥代码，uModifiers 成员标识保留密钥的修饰符。

[in] pchDesc

指向包含保留密钥说明的 Unicode 字符串的指针。 除非 cchDesc 为零，否则不能为 NULL。

[in] cchDesc

指定 pchDesc 中的字符数。 如果不需要说明，则为此参数传递零。

返回值

此方法可以返回其中一个值。

值 说明
S_OK
 方法成功。
TF_E_ALREADY_EXISTS
 已注册保留的密钥。
E_INVALIDARG
 一个或多个参数无效。
E_OUTOFMEMORY
 发生内存分配错误。
E_FAIL
 发生了未指定的错误。

注解

保留的键由 TSF 文本服务注册，并为 TSF 文本服务实现的常见命令提供键盘快捷方式。

要求

   
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 msctf.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

ITfKeyEventSink：：OnPreservedKey

ITfKeystrokeMgr

ITfKeystrokeMgr：：UnpreserveKey

ITfTextInputProcessor：：Activate

TF_PRESERVEDKEY