ITfReadOnlyProperty::EnumRanges メソッド (msctf.h)

指定された範囲内のプロパティの一意の値を含む範囲の列挙を取得します。

構文

HRESULT EnumRanges(
  [in]  TfEditCookie  ec,
  [out] IEnumTfRanges **ppEnum,
  [in]  ITfRange      *pTargetRange
);

[in] ec

編集コンテキストを識別する編集 Cookie が含まれています。これは、 ITfDocumentMgr::CreateContext または ITfEditSession::D oEditSession から取得されます。

[out] ppEnum

列挙子オブジェクトを受け取る IEnumTfRanges インターフェイスポインターへのポインター。呼び出し元は、不要になったときにこのオブジェクトを解放する必要があります。

[in] pTargetRange

一意のプロパティ値をスキャンする範囲を指定する ITfRange インターフェイスへのポインター。このパラメーターは省略可能であり、 NULL にすることができます。詳細については、「解説」を参照してください。

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

値	説明
S_OK	メソッドは正常に実行されました。
E_INVALIDARG	1 つ以上のパラメーターが無効です。
E_OUTOFMEMORY	メモリ割り当てエラーが発生しました。
E_FAIL	未指定のエラーが発生しました。メモアプリケーションで ITextStoreACP::FindNextAttrTransition が実装されていない場合、ITfReadOnlyProperty::EnumRanges はE_FAILで失敗します。
TF_E_NOLOCK	ec によって識別される編集コンテキストには、読み取り専用または読み取り/書き込みロックがありません。

メモ： アプリケーションで ITextStoreACP::FindNextAttrTransition が実装されていない場合、 ITfReadOnlyProperty::EnumRanges は E_FAILで失敗します。

このメソッドによって取得された列挙子には、指定されたプロパティの空の値を含む一意の値ごとに範囲が含まれます。たとえば、架空の色のプロパティは、次のマークアップされたテキストに適用できます。


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text

この範囲に pTargetRange を設定して ITfReadOnlyProperty::EnumRanges を呼び出すと、列挙子には 5 つの範囲が含まれます。

pTargetRange が NULL の場合、列挙子は、コンテキスト内の空でないプロパティ値を含む最初と最後の範囲で開始および終了します。上記の例で pTargetRange に NULL を指定すると、3 つの範囲を持つ列挙子が生成されます。

列挙された範囲は、いずれかのアンカーがプロパティの中央に配置されている場合でも、 pTargetRange の開始アンカーと終了アンカーで開始および終了します。


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