ITextStoreACP2：：InsertEmbeddedAtSelection 方法 (textstor.h)

  • 项目

在插入点或选定位置插入 IDataObject 。 在将 IDataObject 对象插入文档之前，调用此方法的客户端必须具有读/写锁。

语法

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD         dwFlags,
  [in]  IDataObject   *pDataObject,
  [out] LONG          *pacpStart,
  [out] LONG          *pacpEnd,
  [out] TS_TEXTCHANGE *pChange
);

参数

[in] dwFlags

指定 pacpStart 和 pacpEnd 参数以及 TS_TEXTCHANGE 结构是否将包含对象插入的结果。

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

值 含义
0
 将进行文本插入， 并且 pacpStart 和 pacpEnd 参数将包含文本插入的结果。 必须用此标志填充 TS_TEXTCHANGE 结构。
TF_IAS_NOQUERY
 插入文本， pacpStart 和 pacpEnd 参数的值可以为 NULL，并且必须填充 TS_TEXTCHANGE 结构。 如果不需要插入文本的结果，请使用此标志。
TF_IAS_QUERYONLY
 不会插入文本， 并且 pacpStart 和 pacpEnd 参数的值包含文本插入的结果。 这些参数的值取决于应用程序在文档中实现文本插入的方式。 有关详细信息，请参见“备注”部分。

使用此标志可以查看文本插入的结果，而无需实际插入文本，例如，预测折叠或调整所选内容的结果。 无需使用此标志填充 TS_TEXTCHANGE 结构。

[in] pDataObject

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

[out] pacpStart

指向将进行对象插入的起始应用程序字符位置的指针。

[out] pacpEnd

指向将进行对象插入的结束应用程序字符位置的指针。 此参数值将与插入点的 pacpStart 参数的值相同。

[out] pChange

指向具有以下成员 的TS_TEXTCHANGE 结构的指针。

值 含义
acpStart
 将对象插入文档之前的起始应用程序字符位置。
acpOldEnd
 将对象插入文档之前的结束应用程序字符位置。 此值与插入点的 acpStart 相同。 如果此值与 acpStart 不同，则在插入对象之前选择了文本。
acpNewEnd
 对象插入后的结束应用程序字符位置。

返回值

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

值 说明
S_OK
 方法成功。
E_INVALIDARG
 pchText 参数无效。
TS_E_NOLOCK
 调用方对文档没有锁定。

注解

pacpStart 和 pacpEnd 参数的值取决于客户端应用程序如何将对象插入文档。 例如，如果应用程序在插入对象后在对象的开头设置游标，则 pacpStart 和 pacpEnd 参数的值与 TS_TEXTCHANGE 结构的 acpStart 成员相同。

要求

要求 值
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 textstor.h
DLL Msctf.dll

另请参阅

IDataObject

ITextStoreACP2

TF_IAS_* 常量

TS_TEXTCHANGE