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 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー textstor.h
[DLL] Msctf.dll
再頒布可能パッケージ Windows 2000 Professional 上の TSF 1.0