ITextRange.Text Eigenschaft

Definition

Namespace:

Windows.UI.Text

Ruft den Nur-Text des Textbereichs ab oder legt diese fest.

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

Eigenschaftswert

String

Platform::String

winrt::hstring

Der Nur-Text-Inhalt.

Hinweise

Die Text-Eigenschaft ist die Standardeigenschaft für ITextRange. Daher wird sie automatisch für den Textbereich aufgerufen. Beispiel: In einigen der folgenden Beispiele wird diese Tatsache verwendet. print range

Die Text-Methode ersetzt eine Zeichenfolge durch den Bereichstext. Für die Verarbeitung eines einzelnen Zeichens ist die ITextRange.Character-Eigenschaft effizienter als die Text-Eigenschaft und erfordert keine Erstellung eines einzelnen Zeichenbereichs zum Speichern eines Zeichens.

Wenn der Bereich degeneriert ist, können Sie mit der Text-Eigenschaft problemlos Text einfügen. Sie können den Text auch in einem Bereich löschen:range.delete range = ""

Sie können die Text-Eigenschaft verwenden, um Nur-Text von einem Ort an einen anderen zu kopieren, indem Sie einfach einen Bereich gleich einem anderen festlegen. Die folgende Anweisung legt den Text eines Bereichs auf den eines anderen Bereichs fest:range1 = range2

Diese Bereiche können in verschiedenen Geschichten oder sogar in verschiedenen Apps sein. Sie impliziert jedoch das Kopieren des Texts zuerst in eine Zeichenfolge und dann von dieser Zeichenfolge an den Zielspeicherort.

Bei großen Textmengen können die Methoden ITextRange.Copy und ITextRange.Paste schneller sein, da sie den Kopiervorgang direkt von Quelle zu Ziel und in jedem format ausführen können, das von Quelle und Ziel unterstützt wird.

Der von der Text-Eigenschaft zurückgegebene Text wird in Unicode angegeben. Das Ende des Absatzes kann je nach Originaldatei durch eine der folgenden Zeichen angegeben werden:

• 0x2029 (Unicode-Absatztrennzeichen)
• Wagenrücklauf/Zeilenvorschub (CRLF) (0xd, 0xa)
• CR allein (0xd)

Der Platzhalter für ein eingebettetes Objekt wird durch das Sonderzeichen WCH_EMBEDDING angegeben, das den offiziellen Unicode-Wert 0xFFFC hat.