ITfRange インターフェイス (msctf.h)
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 |