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 |
---|---|
|
不支持單位。 |
|
因其他原因而失敗。 |
備註
如果範圍是 Units 之間界限上的插入點, ITextRange::StartOf 不會變更開始位置。
ITextRange::StartOf 和 ITextRange::EndOf 方法與 HomeKey 和 EndKey 方法不同,後者從使用中端延伸,而 ITextRange::StartOf 則從開始位置延伸,而 ITextRange::EndOf 則從結束位置延伸。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | tom.h |
Dll | Msftedit.dll |
另請參閱
概念
參考