ITextStoreACP2::QueryInsert 方法 (textstor.h)

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

语法

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
acpTestStartacpTestEnd 参数无效。

注解

pacpResultStartpacpResultEnd 的值取决于应用程序如何将文本插入文档。 如果 pacpResultStartpacpResultEndacpTextStart 相同,则光标在插入后位于插入文本的开头。 如果 pacpResultStartpacpResultEndacpTextEnd 相同,则光标在插入后位于插入文本的末尾。 如果 pacpResultStartpacpResultEnd 之间的差异等于插入文本的长度,插入后将突出显示插入的文本。

要求

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

另请参阅

ITextStoreACP2