ITextStoreAnchor::InsertTextAtSelection メソッド (textstor.h)

  • [アーティクル]

カーソル位置または選択範囲にテキストを挿入します。

構文

HRESULT InsertTextAtSelection(
  [in]  DWORD       dwFlags,
  [in]  const WCHAR *pchText,
  [in]  ULONG       cch,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

パラメーター

[in] dwFlags

paStart パラメーターと paEnd パラメーターにテキスト挿入の結果を含めるかどうかを指定します。

TF_IAS_NOQUERYフラグとTF_IAS_QUERYONLY フラグを組み合わせることはできません。

値 説明
TF_IAS_NOQUERY
 テキストが挿入され、 ppaStart パラメーターと ppaEnd パラメーターの 値は NULL にすることができます。 テキスト挿入の結果が不要な場合は、このフラグを使用します。
TF_IAS_QUERYONLY
 テキストは挿入されず、 ppaStart アンカーと ppaEnd アンカーにはテキスト挿入の結果が含まれます。 これらのパラメーターの値は、アプリケーションがドキュメントへのテキスト挿入を実装する方法によって異なります。 実際にテキストを挿入せずにテキスト挿入の結果を表示するには、このフラグを使用します。 長さ 0 のテキストを挿入できます。

[in] pchText

ドキュメントに挿入する文字列へのポインター。 文字列は NULL で終了できます。

[in] cch

テキストの長さを指定します。

[out] ppaStart

テキスト挿入の先頭にあるアンカー オブジェクトへのポインター。

[out] ppaEnd

テキスト挿入の最後にあるアンカー オブジェクトへのポインター。 挿入ポイントの場合、このパラメーター値は ppaStart パラメーターの値と同じになります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 説明
S_OK
 メソッドは正常に実行されました。
E_FAIL
 メソッドは、アンカー paStart または paEnd の 1 つをインスタンス化できませんでした。
E_INVALIDARG
 pchText パラメーターが無効です。
TS_E_NOLOCK
 呼び出し元には、ドキュメントに対するロックがありません。

要件

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

関連項目

組成

ITextStoreAnchor

ITextStoreAnchorSink::OnTextChange

TF_IAS_* 定数

TS_TEXTCHANGE