iTextStoreACP：：QueryInsert 方法 (textstor.h)

  • 项目

ITextStoreACP：：QueryInsert 方法确定指定的开始和结束字符位置是否有效。 在执行编辑之前，使用此方法调整对文档的编辑。 方法不得返回文档范围之外的值。

语法

HRESULT QueryInsert(
  [in]  LONG  acpTestStart,
  [in]  LONG  acpTestEnd,
  [in]  ULONG cch,
  [out] LONG  *pacpResultStart,
  [out] LONG  *pacpResultEnd
);

参数

[in] acpTestStart

插入文本的起始应用程序字符位置。

[in] acpTestEnd

插入文本的结束应用程序字符位置。 如果文本插入到某个点而不是替换所选文本，则此值等于 acpTextStart 。

[in] cch

替换文本的长度。

[out] pacpResultStart

返回插入文本的新起始应用程序字符位置。 如果此参数为 NULL，则无法在指定位置插入文本。 此值不能超出文档范围。

[out] pacpResultEnd

返回插入文本的新结束应用程序字符位置。 如果此参数为 NULL，则 pacpResultStart 设置为 NULL ，并且无法在指定位置插入文本。 此值不能超出文档范围。

返回值

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

值 说明
S_OK
 方法成功。
E_FAIL
 发生了未指定的错误。
E_INVALIDARG
 acpTestStart 或 acpTestEnd 参数无效。

注解

pacpResultStart 和 pacpResultEnd 的值取决于应用程序在文档中插入文本的方式。 如果 pacpResultStart 和 pacpResultEnd 与 acpTextStart 相同，则光标位于插入后插入的文本的开头。 如果 pacpResultStart 和 pacpResultEnd 与 acpTextEnd 相同，则光标位于插入后插入的文本的末尾。 如果 pacpResultStart 和 pacpResultEnd 之间的差异等于插入的文本的长度，插入后将突出显示插入的文本。

要求

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