共用方式為

ITextRange：:D elete 方法 (tom.h)

  • 發行項

模擬 DELETE 和 BACKSPACE 鍵，並無 CTRL 鍵按下。

語法

HRESULT Delete(
  long Unit,
  long Count,
  long *pDelta
);

參數

Unit

類型： long

要使用的單位。 Unit 可以是 tomCharacter (預設值) 或 tomWord。

Count

類型： long

要刪除的 單位數目。 如果 Count= 零，則只會刪除範圍中的文字。 如果 Count 大於零， ITextRange：:D elete 的作用就如同按下 DELETE 鍵的 Count 時間一樣。 如果 Count 小於零，它的作用就如同按下 BACKSPACE 鍵的 Count 時間一樣。 預設值為 1。 如需詳細資訊，請參閱＜備註＞一節。

pDelta

類型： long*

已刪除的單位計數。 它可以是 Null。 pDelta 參數設定為等於已刪除的單位數目。 刪除非產生範圍中的文字會算為一個 單位。

傳回值

類型： HRESULT

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

傳回碼 Description
E_ACCESSDENIED
 文字受到寫入保護。
S_FALSE
 因其他原因而失敗。

備註

如果 Count = 零，這個方法會刪除範圍中的文字，也就是說，如果範圍只是插入點，則不會刪除任何內容。

如果 Count 不是零，而且範圍是插入點 (也就是) 變質， | Count| (Count) Units 的絕對值會以 Count 符號指定的邏輯方向刪除，其中正值是本文結尾的方向，而負值則指向本文開頭。

如果 Count 不是零，而且範圍 (包含文字) ，則不論 Unit 和 Count) 的值為何，範圍中的文字都會遭到刪除 (，藉此建立插入點。 然後， | Count|- 1 單位會以 Count 符號所指定的邏輯方向刪除。

透過將 null 字串指派給執行語句 r = 的範圍 (，也可以刪除範圍中的文字，其中 是範圍) 。 不過， ITextRange：:D elete 不需要配置 BSTR。

刪除段落結尾標記 (CR) 會導致 Microsoft Word UI 的特殊行為。 有四個案例特別感興趣：

  • 如果您只刪除CR，但段落包含文字，則會刪除CR，而下列段落會取得與目前段落相同的段落格式設定。
  • 如果您刪除CR以及下列段落中部分但並非全部的字元，則目前段落留下的字元會取得下列段落的段落格式設定。
  • 如果您選取段落結尾，但不是整個段落，則不會刪除CR。
  • 如果您從 CR) 開始刪除整個段落 (，則除非它是檔案) 的最終 CR，否則也會刪除 CR (。

規格需求

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

另請參閱

概念

ITextRange

參考

文字物件模型