ITfInsertAtSelection：：InsertEmbeddedAtSelection 方法 (msctf.h)

项目
08/24/2023

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

插入的对象的位置。可选。

返回值

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

值	说明
S_OK	方法成功。
TF_E_NOLOCK	ec 参数是无效的编辑 Cookie。
TF_E_DISCONNECTED	上下文对象不在文档堆栈上。
TS_E_NOSELECTION	上下文没有选择。
TS_E_READONLY	所选内容是只读的。
TF_E_FORMAT	上下文所有者无法处理 pDataObject 参数提供的类型的对象。

注解

调用方可以使用 ITfQueryEmbedded：：QueryInsertEmbedded 方法来确定此方法是否可能接受特定对象类型。

若要插入文本而不是 IDataObject 对象，请使用 ITfInsertAtSelection：：InsertTextAtSelection 方法。

要求


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