ITextStoreACP::InsertEmbeddedAtSelection 方法 (textstor.h)

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

语法

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

参数

[in] dwFlags

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

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

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

使用此标志可查看文本插入的结果,而无需实际插入文本,例如,预测折叠或以其他方式调整所选内容的结果。 不需要使用此标志填充 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
调用方对文档没有锁定。

注解

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

要求

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

另请参阅

IDataObject

ITextStoreACP

TF_IAS_* 常量

TS_TEXTCHANGE