ITfReadOnlyProperty

ITfReadOnlyProperty インターフェイスは TSF マネージャーによって実装され、アプリケーションまたはテキストサービスがプロパティのデータを取得するために使用します。

このインターフェイスのインスタンスは、ITfContext::GetAppProperty または ITfContext::TrackProperties を使用して取得します。

ITfReadOnlyProperty::GetType メソッド

このメソッドは次のいずれかの値を返します。

ITfReadOnlyProperty::EnumRanges メソッド

このメソッドは次のいずれかの値を返します。

注意: アプリケーションが ITextStoreACP::FindNextAttrTransition を実装していない場合、ITfReadOnlyProperty::EnumRanges は E_FAIL で失敗します。

このメソッドで取得される列挙子には、指定されたプロパティの一意な値ごとに 1 つの範囲 (レンジ) が含まれます。空の値も対象となります。たとえば、仮に色を表すプロパティがあり、次のようにマークアップされたテキストに適用されているとします。

COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text

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

pTargetRange が NULL の場合、列挙子はコンテキスト内で空でないプロパティ値を含む最初の範囲から最後の範囲までを対象とします。上記の例で pTargetRange に NULL を指定すると、列挙子には 3 つの範囲が含まれます。

列挙される範囲は、pTargetRange の開始アンカーと終了アンカーで始まり、そこで終わります。これは、いずれかのアンカーがプロパティの途中に位置している場合でも同様です。

ITfReadOnlyProperty::GetValue メソッド

このメソッドは次のいずれかの値を返します。

pRange の範囲にプロパティの値が存在しない場合、pRange にそのプロパティの値が複数含まれる場合、またはプロパティが pRange 全体を覆っていない場合、pvarValue は VT_EMPTY 値を受け取り、メソッドは S_FALSE を返します。

COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->||<-

COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->|    |<-

COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->|             |<-

ITfReadOnlyProperty::GetContext メソッド

このメソッドは次のいずれかの値を返します。