ITextRange.Delete(TextRangeUnit, Int32) 方法

定義

命名空間:

Microsoft.UI.Text

從文字範圍中刪除文字。

public:
 int Delete(TextRangeUnit unit, int count);

int Delete(TextRangeUnit const& unit, int const& count);

public int Delete(TextRangeUnit unit, int count);

function delete(unit, count)

Public Function Delete (unit As TextRangeUnit, count As Integer) As Integer

參數

unit

TextRangeUnit

要刪除的文字單位。

count

Int32

int

要刪除的 單位 數目。 請參閱＜備註＞。

傳回

Int32

int

已刪除的 單位 數目。 刪除非產生的文字範圍中的文字會計算為一個 單位。

備註

如果 count 為零，這個方法會刪除文字範圍中的所有文字。 如果文字範圍只是插入點 (，也就是變質的範圍) ，則不會刪除任何專案。

如果 count 不是零，而且範圍是插入點， | count | (計數的絕對值，) 單位的絕對值會以 計數 符號指定的邏輯方向刪除，其中正值是接近本文結尾，而負值則指向本文開頭。

如果 count 不是零，而且範圍 (包含文字) ，則會刪除範圍中的文字，而不論 單位 和 計數的值為何，都會導致插入點。 然後， | count | - 1 單位會以計數符號指定的邏輯方向刪除。

範圍中的文字也可以藉由將 Null 字串指派給範圍來刪除。

刪除 CR 會導致下列行為：

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