ITfContext：：SetSelection 方法 (msctf.h)

  • 项目

设置文档中的选择。

语法

HRESULT SetSelection(
  [in] TfEditCookie       ec,
  [in] ULONG              ulCount,
  [in] const TF_SELECTION *pSelection
);

参数

[in] ec

包含标识编辑会话的编辑 Cookie。 这是传递给 ITfEditSession：:D oEditSession 的值。

[in] ulCount

指定 pSelection 数组中的选择数。

[in] pSelection

包含每个选定内容的信息 的TF_SELECTION 结构的数组。

返回值

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

值 说明
S_OK
 方法成功。
TF_E_NOSELECTION
 文档没有选择。
TF_E_NOLOCK
 ec 中的 Cookie 无效。

注解

所选内容是突出显示文本的范围，如果范围为空，则为插入点，用于标识文档中的用户焦点区域。 某些文档能够进行多个选择。 pSelection 中只能有一个零长度选择，因为它表示文档插入符号的位置。

如果应用程序必须调整所选内容所涵盖的文本，则应等待调用方释放锁。 但是，应用程序可以调整TF_SELECTION结构的任何样式成员，同时仍返回S_OK。

仅当设置了一个选择时，调用方才能设置 fInterimChar 标志。 在这种情况下，所选内容应恰好跨越一个字符，并且 TF_SELECTION 结构的 ase 成员设置为 TFAE_NONE。

要求

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

另请参阅

ITfContext 接口、 ITfEditSession：:D oEditSession、 TF_SELECTION 结构、 ITfContext：：GetSelection