ITextSelection：：MoveRight 方法 (tom.h)

發行項
03/03/2024

一般化向右鍵的功能。

語法

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

參數

Unit

類型： long

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

值	對應的按鍵組合	意義
tomCharacter	向右鍵	將一個字元位置向右移動。此為預設值。
tomWord	Ctrl+向右鍵	將一個單字移至右邊。

請注意，如果 Count 小於零，移動會位於左側。

Count

類型： long

要移動的單位數目。預設值為 1。如果 Count 小於零，移動會向左移動。

Extend

類型： long

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

pDelta

類型： long*

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

傳回值

類型： HRESULT

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

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

備註

Microsoft WordBasic 移動方法，例如 CharRight、 CharLeft、 WordRight 和 WordLeft 是混合式，可以執行四個與標準箭頭鍵編輯行為緊密相關的動作：

如果沒有選取範圍，請移動目前的插入點。
如果有選取範圍，請移動選取範圍的作用中結尾。
將插入點轉換成選取範圍，反之亦然。
傳回布爾值，指出是否發生移動。

MoveLeft 和 MoveRight 的 Extend 自變數可讓您與上述前三個專案一致，而 pDelta 是第四個專案的一般化。例如，假設選取範圍是由單一範圍所組成，您有下列對應 (，以) 從左至右字元。

ITextSelection	WordBasic	函式
s.MoveRight tomWord， 1， 1	WordRight 1,1	向右移動使用中結尾一個字。
s.MoveLeft tomCharacter， 1， 1	CharLeft 1,1	將作用中結尾移到左一個字元。

如同 WordBasic，如果 Count 小於零，則左右的意義會交換，這 MoveLeft (Unit, Count, Extend) 相當於 MoveRight(Unit, -Count, Extend)。

類似於 WordBasic 和向右鍵 UI 行為，在變質選取範圍上呼叫 MoveRight(Unit, Count) 會移動插入點指定的單位數。在變質範圍上，呼叫 MoveRight(Unit, Count, 1) 大於零的位置 Count 會導致範圍變成非產生，而右端為使用中端。

當 Extend 是 tomExtend (或非零) 時， MoveRight 只會移動選取範圍的作用中端，保留其所在的另一端。不過，如果 Extend 等於零，且選取範圍會以非產生範圍開始， MoveRight(Unit, Count) 其中 Count 大於零會向右移動使用中端 Count - 1 個單位，然後將另一端移至使用中端。換句話說，它會在作用中端建立插入點。折疊範圍會計算為一個單位。因此， MoveRight(tomCharacter) 將非產生的選取範圍轉換成選取範圍右端的變質選取範圍。在這裡， Count 的預設值為 1， 而 Extend 的預設值為零。本範例會對應至按下向右鍵。 MoveLeft 和 MoveRight 與 ITextRange 移動方法相關，但不同之處在於它們會明確地使用使用中端， (按下 Shift 鍵) 移動的結尾。

規格需求

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