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 と等しい場合は、先頭の文字列の下に挿入されます。