ITfInsertAtSelection：：InsertEmbeddedAtSelection 方法 (msctf.h)
ITfInsertAtSelection：：InsertEmbeddedAtSelection 方法在选择点或插入点插入 IDataObject 对象。
语法
HRESULT InsertEmbeddedAtSelection(
[in] TfEditCookie ec,
[in] DWORD dwFlags,
[in] IDataObject *pDataObject,
[out] ITfRange **ppRange
);
parameters
[in] ec
标识编辑上下文。 这是从 ITfDocumentMgr：：CreateContext 或 ITfEditSession：:D oEditSession 获取的。
[in] dwFlags
具有以下值之一的位字段：
TF_IAS_NOQUERY
退出时，ppRange 参数为 NULL。
TF_IAS_QUERYONLY
上下文未修改，但 ppRange 参数的设置与插入发生一样。 只读访问权限就足够了。 如果未设置此标志， 则 ec 参数必须具有读/写访问权限。
TF_IAS_NO_DEFAULT_COMPOSITION
如果需要组合，TSF 管理器不会创建默认组合。 调用方必须在释放上下文锁之前创建一个包含插入文本的合成对象。
[in] pDataObject
指向要插入的对象的指针。
[out] ppRange
插入的对象的位置。 可选。
返回值
此方法可以返回其中一个值。
| 值 | 说明 |
|---|---|
|
方法成功。 |
|
ec 参数是无效的编辑 Cookie。 |
|
上下文对象不在文档堆栈上。 |
|
上下文没有选择。 |
|
所选内容是只读的。 |
|
上下文所有者无法处理 pDataObject 参数提供的类型的对象。 |
注解
调用方可以使用 ITfQueryEmbedded：：QueryInsertEmbedded 方法来确定此方法是否可能接受特定对象类型。
若要插入文本而不是 IDataObject 对象，请使用 ITfInsertAtSelection：：InsertTextAtSelection 方法。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | msctf.h |
| DLL | Msctf.dll |
| 可再发行组件 | Windows 2000 专业版上的 TSF 1.0 |
另请参阅
ITfEditSession：:D oEditSession