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 oEditSessionTF_SELECTION 结构ITfContext::GetSelection