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 是插入點或開始位置移動的帶正負號字元數。 這個值一律小於或等於零,因為動作一律接近本文的開頭。

傳回值

類型: HRESULT

方法會傳回 HRESULT 值。 如果方法成功,它會 傳回S_OK。 如果方法失敗,它會傳回下列其中一個錯誤碼。 如需 COM 錯誤碼的詳細資訊,請參閱 COM 中的錯誤處理

傳回碼 Description
E_NOTIMPL
不支持單位。
S_FALSE
因其他原因而失敗。

備註

如果範圍是 Units 之間界限上的插入點, ITextRange::StartOf 不會變更開始位置。

ITextRange::StartOfITextRange::EndOf 方法與 HomeKeyEndKey 方法不同,後者從使用中端延伸,而 ITextRange::StartOf 則從開始位置延伸,而 ITextRange::EndOf 則從結束位置延伸。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 tom.h
Dll Msftedit.dll

另請參閱

概念

EndKey

EndOf

HomeKey

ITextRange

參考

文字物件模型