ITextRange.Text プロパティ

定義

名前空間:

Microsoft.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 プロパティを使用すると、ある範囲を別の範囲に設定するだけで、ある場所から別の場所にプレーン テキストをコピーできます。 次のステートメントは、ある範囲のテキストを別の範囲のテキストに設定します。range1 = range2

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

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

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

• 0x2029 (Unicode 段落区切り記号)
• キャリッジ リターン/ライン フィード (CRLF) (0xd、0xa)
• CR 単独 (0xd)

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