Share via

ITextRange::EndOf メソッド (tom.h)

  • [アーティクル]

この範囲の末尾を、範囲内の最後の重なり合う 単位 の末尾に移動します。

構文

HRESULT EndOf(
  long Unit,
  long Extend,
  long *pDelta
);

パラメーター

Unit

型: long

使用する単位。 既定値: tomWord。 その他の Unit 値の一覧については、「 ITextRange」の説明を参照してください。

Extend

型: long

範囲のシフトがどのように終了するかを示すインジケーター。 次のいずれかになります。

0 または tomMove 挿入ポイントを移動して、元の範囲の End まで、生成されていない範囲を折りたたみます。 既定値です。
1 (または tomExtend) [End]\(終了\) を、重複するユニットの末尾に移動 します。 Start を移動しません。

pDelta

種類: long*

End が過去に移動した文字数。 ポインターの値は null にすることができます。 戻り値の pDelta の値は、挿入ポイントが移動された文字数、またはエントリ End に折りたたみがある場合は End が 1 を 加算 した文字数です。 範囲に最終的な CR (キャリッジ リターン) (ストーリーの末尾) と Extend = tomMove が含まれている場合、 pDelta は –1 に設定され、範囲の末尾 の前に 折りたたみが発生したことを示します (挿入ポイントが最後の CR を超えて存在できないため)。

戻り値

種類: HRESULT

メソッドは HRESULT 値を返します。 メソッドが成功すると、 S_OKが返されます。 メソッドが失敗した場合は、次のいずれかのエラー コードが返されます。 COM エラー コードの詳細については、「COM でのエラー処理」を参照してください。

リターン コード 説明
E_NOTIMPL
 ユニットはサポートされていません。
S_FALSE
 何らかの理由で失敗しました。

注釈

比較のために、 ITextRange::StartOf メソッドは範囲の最初の重なり合う Unit の先頭に範囲の末尾を移動します。 ITextRange::StartOf メソッドと ITextRange::EndOf メソッドは、HomeKey メソッドと EndKey メソッドとは異なり、後者はアクティブな終了から拡張されますが、ITextRange::StartOf は Start から拡張され、ITextRange::EndOf は End から拡張されます。 範囲が ユニット間の境界上の挿入ポイントである場合、 ITextRange::EndOf は End を変更しません。 特に、 ITextRange::EndOf (tomCharacter, *, *) を呼び出しても、ストーリーの先頭に挿入ポイントがある場合を除き、End は変更されません。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー tom.h
[DLL] Msftedit.dll

関連項目

概念

EndKey

HomeKey

ITextRange

リファレンス

StartOf

Text オブジェクト モデル