ITextSelection：：MoveUp 方法 (tom.h)

發行項
03/03/2024

模擬向上鍵和頁面向上鍵的功能。

語法

HRESULT MoveUp(
  long Unit,
  long Count,
  long Extend,
  long *pDelta
);

參數

Unit

類型： long

作業中使用的單位。它可以是下列其中一項。

值	對應的按鍵組合	意義
tomLine	向上箭號	向上移動一行。此為預設值。
tomParagraph	Ctrl+向上鍵	向上移動一個段落。
tomScreen	Page Up	向上移動一個畫面。
tomWindow	Ctrl+Page Up	移至視窗中的第一個字元。

Count

類型： long

要移動的單位數目。預設值為 1。

Extend

類型： long

指出如何變更選取範圍的旗標。如果 Extend 為零 (或 tomMove) ，則方法會將選取範圍折疊至插入點，然後移動。如果 Extend 為 1 (或 tomExtend) ，則方法會移動使用中端，並單獨離開另一端。預設值為零。非零 的 Extend 值會對應到除了 Unit 中所述的按鍵組合之外，要按下的 Shift 鍵。

pDelta

類型： long*

插入點或作用中結束的實際單位計數會向下移動。此參數可以是 null。折疊選取範圍會計算為一個單位。

傳回值

類型： HRESULT

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

傳回碼	Description
E_INVALIDARG	單位無效。
S_FALSE	因其他原因而失敗。

備註

MoveUp 和 MoveDown 方法類似於 MoveLeft 和 MoveRight 方法，不同之處在於它們反映游標鍵上向上鍵、向下鍵、頁面向上鍵和頁面向下鍵的行為。

規格需求

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