ITextRange.Text 屬性

定義

命名空間:

Windows.UI.Text

取得或設定文字範圍的純文字。

public:
 property Platform::String ^ Text { Platform::String ^ get(); void set(Platform::String ^ value); };

winrt::hstring Text();

void Text(winrt::hstring value);

public string Text { get; set; }

var string = iTextRange.text;
iTextRange.text = string;

Public Property Text As String

屬性值

String

Platform::String

winrt::hstring

純文字。

備註

Text 屬性是 ITextRange的預設屬性。 因此，系統會自動針對文字範圍叫用它。 例如：下列部分範例會使用此事實。 print range

Text 方法會取代範圍文字的字串。 為了處理單一字元， ITextRange.Character 屬性比 Text 屬性更有效率，而且不需要建立單一字元範圍來儲存字元。

如果範圍變質，Text 屬性可讓您輕鬆地插入文字。 您也可以刪除範圍中的文字：range.delete range = ""

您可以使用 Text 屬性，將純文字從某個位置複製到另一個位置，只要將一個範圍設定為另一個範圍即可。 下列語句會將某個範圍的文字設定為另一個範圍的文字：range1 = range2

這些範圍可以位於不同的故事中，甚至是在不同的應用程式中。 不過，它們確實會先將文字複製到字串，然後將該字串複製到目標位置。

對於大量的文字， ITextRange.Copy 和 ITextRange.Paste 方法可能會更快，因為它們可以直接從來源對目標執行複製，以及來源和目標支援的任何格式。

Text 屬性傳回的文字會在 Unicode 中提供。 視原始檔案而定，下列其中一項可能會提供段落結束記號：

• 0x2029 (Unicode 段落分隔符號)
• 歸位字元/換行字元 (CRLF) (0xd，0xa)
• CR 單獨 (0xd)

内嵌物件的預留位置是由具有官方 Unicode 值0xFFFC的特殊字元所指定WCH_EMBEDDING。