ITextStoreAnchor：：QueryInsert 方法 (textstor.h)

  • 项目

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

语法

HRESULT QueryInsert(
  [in]  IAnchor *paTestStart,
  [in]  IAnchor *paTestEnd,
  [in]  ULONG   cch,
  [out] IAnchor **ppaResultStart,
  [out] IAnchor **ppaResultEnd
);

参数

[in] paTestStart

接收指向插入文本的起始定位点的指针。

[in] paTestEnd

接收指向插入文本的结束定位点的指针。 如果文本插入到某个点而不是替换所选文本，则这与 paTestStart 相同。

[in] cch

替换文本的长度。

[out] ppaResultStart

指向插入文本的起始位置处的新定位点对象的指针。 如果此参数的值为 NULL，则无法在指定位置插入文本。 此定位点不能位于文档外部。

[out] ppaResultEnd

指向插入文本的结束位置处的新定位点对象的指针。 如果此参数的值为 NULL，则无法在指定位置插入文本。 此定位点不能位于文档外部。

返回值

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

值 说明
S_OK
 方法成功。
E_FAIL
 发生了未指定的错误。
E_INVALIDARG
 paTestStart 或 paTestEnd 参数无效。
E_OUTOFMEMORY
 尝试实例化 ppaResultStart 和/或 ppaResultEnd 定位点失败。

注解

ppaResultStart 和 ppaResultEnd 的值取决于应用程序如何将文本插入文档。 如果 ppaResultStart 和 ppaResultEnd 与 paTestStart 相同，则光标在插入后位于插入文本的开头。 如果 ppaResultStart 和 ppaResultEnd 与 paTextEnd 相同，则光标在插入后位于插入文本的末尾。

要求

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