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 メソッドは、範囲テキストの文字列を置き換えます。 1 つの文字を処理する場合、 ITextRange.Character プロパティは Text プロパティよりも効率的であり、文字を格納するために 1 つの文字範囲を作成する必要はありません。

範囲が縮退している場合、Text プロパティを使用すると、テキストを簡単に挿入できます。 範囲内のテキストを削除することもできます。range.delete range = ""

Text プロパティを使用すると、ある範囲を別の範囲に設定するだけで、プレーン テキストを 1 つの場所から別の場所にコピーできます。 次のステートメントは、ある範囲のテキストを別の範囲のテキストに設定します。range1 = range2

これらの範囲は、異なるストーリーでも、異なるアプリでもかまいません。 ただし、テキストを最初に文字列にコピーしてから、その文字列からターゲットの場所にコピーすることを意味します。

大量のテキストの場合、 ITextRange.Copy メソッドと ITextRange.Paste メソッドは、ソースからターゲットに直接、およびソースとターゲットでサポートされている任意の形式でコピーを実行できるため、高速になります。

Text プロパティによって返されるテキストは、Unicode で指定されます。 段落末記号は、元のファイルに応じて、次のいずれかによって指定できます。

• 0x2029 (Unicode 段落区切り記号)
• 復帰/改行 (CRLF) (0xd、0xa)
• CR 単独 (0xd)

埋め込みオブジェクトのプレースホルダーは、公式の Unicode 値0xFFFCを持つ特殊文字 WCH_EMBEDDINGによって指定されます。