ITfRange インターフェイス (msctf.h)

[アーティクル]
08/24/2023

ITfRange インターフェイスは、特定のコンテキスト内でテキストを参照および操作するために、テキストサービスとアプリケーションによって使用されます。インターフェイス ID がIID_ITfRange。

継承

ITfRange インターフェイスは、IUnknown インターフェイスから継承されます。 ITfRange には、次の種類のメンバーもあります。

メソッド

ITfRange インターフェイスには、これらのメソッドがあります。


ITfRange::AdjustForInsert ITfRange::AdjustForInsert メソッドは、テキストの挿入に合わせて調整するテキストの範囲を拡張または縮小します。
ITfRange::Clone ITfRange::Clone メソッドは、このテキスト範囲を複製します。
ITfRange::Collapse ITfRange::Collapse メソッドは、開始アンカーと終了アンカーを同じ位置に移動することで、テキストの範囲をクリアします。
ITfRange::CompareEnd ITfRange::CompareEnd メソッドは、このテキスト範囲の終了アンカー位置を別の範囲のアンカーと比較します。
ITfRange::CompareStart ITfRange::CompareStart メソッドは、このテキスト範囲の開始アンカー位置を別の範囲のアンカーと比較します。
ITfRange::GetContext ITfRange::GetContext メソッド
ITfRange::GetEmbedded ITfRange::GetEmbedded メソッドは、テキストストリーム内のTS_CHAR_EMBEDDED文字に対応するコンテンツを取得します。テキスト範囲の開始アンカーは、目的の文字の直前に配置されます。
ITfRange::GetFormattedText ITfRange::GetFormattedText メソッドは、テキストの範囲内に含まれる書式設定されたコンテンツを取得します。コンテンツは、IDataObject インターフェイスをサポートするオブジェクトにパッケージ化されます。
ITfRange::GetGravity ITfRange::GetGravity メソッド
ITfRange::GetText ITfRange::GetText メソッドは、このテキスト範囲の対象となるコンテンツを取得します。
ITfRange::InsertEmbedded ITfRange::InsertEmbedded メソッドは、テキスト範囲の開始アンカーの位置にオブジェクトを挿入します。
ITfRange::IsEmpty ITfRange::IsEmpty メソッドは、開始アンカーと終了アンカーが同じ位置を占めているため、テキストの範囲が空であることを確認します。
ITfRange::IsEqualEnd ITfRange::IsEqualStart メソッドは、このテキスト範囲の終了アンカーが別の指定範囲のアンカーと一致することを確認します。
ITfRange::IsEqualStart ITfRange::IsEqualStart メソッドは、このテキスト範囲の開始アンカーが、指定された別の範囲のアンカーと一致することを確認します。
ITfRange::SetGravity ITfRange::SetGravity メソッド
ITfRange::SetText ITfRange::SetText メソッドは、テキスト範囲の対象となるコンテンツを置き換えます。
ITfRange::ShiftEnd ITfRange::ShiftEnd メソッド
ITfRange::ShiftEndRegion ITfRange::ShiftEndRegion メソッド
ITfRange::ShiftEndToRange ITfRange::ShiftEndToRange メソッド
ITfRange::ShiftStart ITfRange::ShiftStart メソッド
ITfRange::ShiftStartRegion ITfRange::ShiftStartRegion メソッド
ITfRange::ShiftStartToRange ITfRange::ShiftStartToRange メソッド

解説

TSF マネージャーは、このインターフェイスを実装します。 TSF で使用される範囲、アンカー、埋め込みオブジェクト、およびその他のテキストプロパティの詳細については、「Using Text Services Framework」の「範囲、埋め込みオブジェクト、およびその他のトピック」を参照してください。

例

ITfComposition 合成オブジェクトがインスタンス化されると、次のコード例に示すように ITfComposition::GetRange メソッドを呼び出すことで、ITfRange インターフェイスポインターへのポインターを取得できます。


HRESULT         hr;
ITfComposition  *pComposition;
ITfRange        *pRange;
WCHAR           *achBuffer[64];  // Buffer to receive text. 
ULONG           cch;

hr = pComposition->GetRange(&pRange);
if(SUCCEEDED(hr))
{
    // Loop to scan text: 

    do
    {
        cch = ARRAYSIZE(achBuffer);
        hr = pRange->GetText(ec, TF_TF_MOVESTART | TF_TF_IGNOREEND, achBuffer, cch, &cch);
        if(SUCCEEDED(hr))
        {
            // Do something with the text. 

            pRange->Release();
        }
    }
    while (cch == ARRAYSIZE(achBuffer));

    pComposition->Release();
}

現在の ITfRange オブジェクトへのポインターは、TF_SELECTION構造体の range> 要素から<取得できます。

要件


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

次の方法で共有

ITfRange インターフェイス (msctf.h)

継承

メソッド

解説

例

要件

関連項目

フィードバック

フィードバック

その他のリソース