ITextStoreAnchor：：InsertEmbeddedAtSelection 方法 (textstor.h)

项目
03/02/2024

ITextStoreAnchor：：InsertEmbeddedAtSelection 方法在插入点或选定内容处插入 IDataObject 对象。在将 IDataObject 插入文本流之前，调用此方法的客户端必须具有读/写锁。

语法

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD       dwFlags,
  [in]  IDataObject *pDataObject,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

参数

[in] dwFlags

指定 paStart 和 paEnd 参数是否将包含对象插入的结果。

不能将TF_IAS_NOQUERY标志和TF_IAS_QUERYONLY标志组合在一起。

值	含义
TF_IAS_NOQUERY	插入文本， ppaStart 和 ppaEnd 参数的值可以为 NULL。如果不需要文本插入的结果，请使用此标志。
TF_IAS_QUERYONLY	不会插入文本，并且 ppaStart 和 ppaEnd 定位点包含文本插入的结果。这些参数的值取决于应用程序如何将文本插入到文档中。使用此标志可查看文本插入的结果，而无需实际插入文本，例如，预测折叠或以其他方式调整所选内容的结果。

[in] pDataObject

指向要插入的 IDataObject 对象的指针。

[out] ppaStart

指向对象插入开始时定位点对象的指针。

[out] ppaEnd

指向对象插入末尾的定位点对象的指针。对于插入点，此参数值将与 ppaStart 参数的值相同。

返回值

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

值	说明
S_OK	方法成功。
E_FAIL	方法无法实例化其中一个定位点 paStart 或 paEnd。
E_INVALIDARG	pchText 参数无效。
E_OUTOFMEMORY	方法无法实例化其中一个定位点 paStart 或 paEnd。
TS_E_NOLOCK	调用方对文档没有锁定。

注解

客户端必须使用此方法将对象插入文本流，因为无法将TS_CHAR_EMBEDDED 常量传递到 ITextStoreAnchor：：SetText 中。

要求

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