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

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

構文

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

パラメーター

Unit

型: long

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

Extend

型: long

範囲の端を移動する方法。 次のいずれかの値を指定できます。

0 (または tomMove)	カーソルを移動して、生成されていない範囲を開始位置まで折りたたみます。 既定値です。
1 (または tomExtend)	開始位置を、重なり合う単位の先頭に移動 します。 終了位置は移動しません。

pDelta

型: long*

開始位置が移動される文字数を受け取る変数へのポインター。 null にすることができます。 戻り値の pDelta は、挿入ポイントまたは開始位置が移動される符号付き文字数です。 モーションは常にストーリーの先頭に向かうため、この値は常に 0 以下です。

戻り値

型: HRESULT

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

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

注釈

範囲が 単位s の境界上の挿入ポイントである場合、 ITextRange::StartOf は開始位置を変更しません。

ITextRange::StartOf メソッドと ITextRange::EndOf メソッドは HomeKey メソッドと EndKey メソッドとは異なり、後者はアクティブな終了位置から拡張されますが、ITextRange::StartOf は開始位置から拡張され、ITextRange::EndOf は終了位置から拡張されます。

要件

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

関連項目

概念

EndKey

EndOf

HomeKey

ITextRange

リファレンス

Text オブジェクト モデル