ITextStoreACP：：InsertTextAtSelection 方法 (textstor.h)

  • 项目

ITextStoreACP：：InsertTextAtSelection 方法在插入点或选定位置插入文本。 在插入文本之前，调用方必须对文档具有读/写锁定。

语法

HRESULT InsertTextAtSelection(
  [in]  DWORD         dwFlags,
  [in]  const WCHAR   *pchText,
  [in]  ULONG         cch,
  [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] pchText

指向要插入文档中的字符串的指针。 字符串可以以 NULL 结尾。

[in] cch

指定文本长度。

[out] pacpStart

指向开始插入文本的应用程序字符位置的指针。

[out] pacpEnd

指向文本插入发生位置的结束应用程序字符位置的指针。 此参数值与插入点的 pacpStart 参数的值相同。

[out] pChange

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

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

返回值

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

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

注解

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

应用程序不应调用 ITextStoreACPSink：：OnTextChange 方法以响应此方法。

要求

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

另请参阅

成分

ITextStoreACP

ITextStoreACPSink：：OnTextChange

TF_IAS_* 常量

TS_TEXTCHANGE