ITfEditRecord::GetTextAndPropertyUpdates メソッド (msctf.h)

  • [アーティクル]

編集セッション中に変更された、指定したプロパティやテキストをカバーする範囲オブジェクトのコレクションを含む列挙子を取得します。

構文

HRESULT GetTextAndPropertyUpdates(
  [in]  DWORD         dwFlags,
  [in]  const GUID    **prgProperties,
  [in]  ULONG         cProperties,
  [out] IEnumTfRanges **ppEnum
);

パラメーター

[in] dwFlags

このメソッドの動作を指定する次の値の組み合わせを含みます。

値 説明
0
 メソッドが、編集セッション中に変更された指定されたプロパティをカバーする範囲オブジェクトのコレクションを取得することを指定します。 prgProperties を NULL にすることはできません。 cProperties は 0 より大きくする必要があります。
TF_GTP_INCL_TEXT
 メソッドが、編集セッション中に変更されたテキストをカバーする範囲オブジェクトのコレクションを取得することを指定します。

[in] prgProperties

変更を検索するプロパティを識別する GUID 値の配列へのポインター。 このメソッドは、編集セッション中に変更されたプロパティを検索し、プロパティがこの配列に含まれている場合は、変更されたプロパティをカバーする範囲オブジェクトが ppEnum に追加されます。

この配列は、少なくとも cProperties 要素のサイズである必要があります。

dwFlags にTF_GTP_INCL_TEXTが含まれており、cProperties が 0 の場合、このパラメーターは無視されます。

[in] cProperties

prgProperties 配列内の要素の数を指定します。

dwFlags に TF_GTP_INCL_TEXTが含まれている場合、このパラメーターは 0 にすることができます。 これは、プロパティの変更が取得されていないことを示します。

[out] ppEnum

列挙子オブジェクトを受け取る IEnumTfRanges インターフェイス ポインターへのポインター。

戻り値

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

値 説明
S_OK
 メソッドは正常に実行されました。
E_INVALIDARG
 1 つ以上のパラメーターが無効です。
E_OUTOFMEMORY
 メモリ割り当てエラーが発生しました。

要件

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

関連項目

IEnumTfRanges

ITfEditRecord