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

この範囲の先頭の文字位置を設定します。

構文

HRESULT SetStart(
  [in] long cpFirst
);

[in] cpFirst

型: long

範囲の先頭の新しい文字位置。

種類: HRESULT

メソッドは HRESULT 値を返します。メソッドが成功すると、 S_OKが返されます。メソッドが失敗した場合は、S_FALSEを返します。

cpFirst が範囲の終了位置より大きい場合、このメソッドは終了位置を cpFirst に設定し、範囲を挿入ポイントにすることに注意してください。この範囲が選択範囲の場合、開始位置はアクティブな終了位置になり、表示が固定されていない場合はスクロールして表示されます。

ITextRange::SetEnd は範囲の終了位置を設定し、 ITextRange::SetRange は両方の範囲の終了を同時に設定します。次の例は、非生成範囲を縮退された範囲 (挿入ポイント) に変換する方法を示しています。

range.End = range.Start

同様に、 range.Start = range.End 範囲を終了位置の挿入ポイントに変換します。

次の例では、ストーリーの末尾にない場合は、終了位置に 1 を追加します。

range.End = range.End + 1

これにより、終了位置が範囲のアクティブな終了位置になり、縮退した範囲を非生成の範囲に変換することもできます。