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
プロパティ値
プレーンテキスト。
注釈
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によって指定されます。