ITextSelection：：MoveLeft 方法 (tom.h)

發行項
03/15/2023

一般化向左鍵的功能。

語法

HRESULT MoveLeft(
  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	因其他原因而失敗。

備註

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

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

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

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

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

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

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

規格需求


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