iTextStrings：：Append 方法 (tom.h)

将字符串追加到集合中指定索引处的字符串。

语法

HRESULT Append(
  [in] ITextRange2 *pRange,
  [in] long        iString
);

[in] pRange

要追加的字符串。

[in] iString

类型： long

字符串索引。

类型： HRESULT

如果该方法成功，则返回 S_OK。如果方法失败，它将返回以下 COM 错误代码之一。有关 COM 错误代码的详细信息，请参阅 COM 中的错误处理。

返回代码	说明
E_INVALIDARG	无效的参数。
E_OUTOFMEMORY	内存不足。

索引相对于集合顶部，因此，如果 iString 等于 0，字符串将插入到集合顶部。如果 iString 等于 –1，则将其插入到顶部字符串的下方，依此插入。