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

指定した単位数を指定した方向に範囲の開始位置を移動します。

構文

HRESULT MoveStart(
  long Unit,
  long Count,
  long *pDelta
);

Unit

型: long

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

Count

型: long

移動する単位数。既定値は 1 です。 Count が 0 より大きい場合、モーションはストーリーの末尾に向かって進み、Count が 0 未満の場合、モーションは先頭に向かって後方になります。 Count が 0 の場合、開始位置は変更されません。

pDelta

型: long*

終了が移動される実際の単位数。値は null でもかまいません。

型: HRESULT

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

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

新しい開始が古い終了に続く場合、新しい終了は新しい開始と同じに設定されます。

ITextRange::MoveStart によって記述されるモーションは、幾何学的ではなく論理的です。つまり、モーションは、ストーリーの末尾または開始に向かって行います。言語によっては、ストーリーの最後に移動すると、左に移動したり、右に移動したりする場合があります。

詳細については、「 ITextRange 」および「 ITextRange::Move」を参照してください。