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 结构的数组。
返回值
此方法可以返回其中一个值。
值 | 说明 |
---|---|
|
方法成功。 |
|
文档没有选择。 |
|
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