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
 acpTestStart パラメーターまたは acpTestEnd パラメーターが無効です。

注釈

pacpResultStart と pacpResultEnd の値は、アプリケーションがドキュメントにテキストを挿入する方法によって異なります。 pacpResultStart と pacpResultEnd が acpTextStart と同じ場合、カーソルは挿入後に挿入されたテキストの先頭にあります。 pacpResultStart と pacpResultEnd が acpTextEnd と同じ場合、カーソルは挿入後に挿入されたテキストの末尾にあります。 pacpResultStart と pacpResultEnd の差が挿入されたテキストの長さと等しい場合は、挿入後に挿入されたテキストが強調表示されます。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー textstor.h
[DLL] Msctf.dll

こちらもご覧ください

ITextStoreACP2