ITextRange.Text プロパティ

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

テキスト範囲のプレーンテキストを取得または設定します。

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 で指定されます。段落末記号は、元のファイルに応じて、次のいずれかによって指定できます。

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