TextRange 類別

定義

命名空間:

System.Windows.Documents

組件:

PresentationFramework.dll

表示兩個 TextPointer 位置之間的內容選取範圍。

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

繼承

Object

TextRange

衍生

System.Windows.Documents.TextSelection

範例

下列範例示範如何使用 TextRange 的 Text 屬性，傳回指定之 FlowDocument的純文本表示。

// This method returns a plain text representation of a specified FlowDocument.
string GetTextFromFlowDocument(FlowDocument flowDoc)
{
     // Create a new TextRanage that takes the entire FlowDocument as the current selection.
     TextRange flowDocSelection = new TextRange(flowDoc.ContentStart, flowDoc.ContentEnd);
      
     // Use the Text property to extract a string that contains the unformatted text contents 
     // of the FlowDocument.
     return flowDocSelection.Text;
}

' This method returns a plain text representation of a specified FlowDocument.
Private Function GetTextFromFlowDocument(ByVal flowDoc As FlowDocument) As String
    ' Create a new TextRanage that takes the entire FlowDocument as the current selection.
    Dim flowDocSelection As New TextRange(flowDoc.ContentStart, flowDoc.ContentEnd)

    ' Use the Text property to extract a string that contains the unformatted text contents 
    ' of the FlowDocument.
    Return flowDocSelection.Text
End Function

備註

TextRange 類別引進下列術語。

• 選取範圍 - TextRange 是 textPointers 所指示的兩個位置之間的內容選取範圍。 其中一個位置是相對於選取範圍的固定錨點，而另一個位置則是可移動的。 這與使用滑鼠或鍵盤的使用者所做的選取方式類似。

• 目前選取範圍 - 因為 TextRange 一律會指出內容中的選取範圍，所以只要將 TextRange 所指示的選取範圍稱為 目前的選取範圍，就有意義了。

• 文字容器 - 文字容器 是構成手邊流程內容最終框線的專案;TextRange 所指示的選取範圍一律落在文字容器內。 目前，文字容器必須是 FlowDocument 或 TextBlock。

• 檔 - 文字容器中共同包含的內容稱為 檔。

如需其他相關詞彙的詳細資訊，例如 位置，請參閱 TextPointer。

建構函式

TextRange(TextPointer, TextPointer)

初始化 TextRange 類別的新實例，採用兩個指定的 TextPointer 位置作為新範圍的開始和結束位置。

屬性

End	取得標示目前選取範圍結尾的位置。
IsEmpty	取得值，指出目前的選取範圍是否為空白。
Start	取得標記目前選取範圍開頭的位置。
Text	取得或設定目前選取範圍的純文本內容。

方法

ApplyPropertyValue(DependencyProperty, Object)	將指定的格式化屬性和值套用至目前的選取範圍。
CanLoad(String)	檢查目前的選取範圍是否可以以指定的數據格式載入內容。
CanSave(String)	檢查目前的選取範圍是否可以儲存為指定的數據格式。
ClearAllProperties()	從目前的選取範圍中移除所有格式化屬性（以 Inline 元素表示）。
Contains(TextPointer)	檢查位置（由 TextPointer所指定）是否位於目前的選取範圍內。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetPropertyValue(DependencyProperty)	傳回目前選取範圍上指定之格式化屬性的有效值。
GetType()	取得目前實例的 Type。 (繼承來源 Object)
Load(Stream, String)	從指定的數據流載入指定數據格式的目前選取範圍。
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
Save(Stream, String, Boolean)	使用保留自訂 TextElement 物件的選項，將目前的選取範圍儲存至指定的數據格式指定的數據流。
Save(Stream, String)	以指定的數據格式，將目前的選取範圍儲存至指定的數據流。
Select(TextPointer, TextPointer)	更新目前的選取範圍，採用兩個 TextPointer 位置來指出更新的選取範圍。
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)

事件

Changed

發生於重新定位範圍以涵蓋新內容範圍時。

另請參閱

• TextPointerContext