Freigeben über


ITextRange Schnittstelle

Definition

Stellt eine Spanne von fortlaufendem Text in einem Dokument dar und bietet leistungsstarke Bearbeitungs- und Datenbindungseigenschaften und -methoden, die es einer App ermöglichen, Dokumenttext auszuwählen, zu untersuchen und zu ändern.

public interface class ITextRange
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1537101399, 49266, 17056, 137, 69, 175, 80, 62, 229, 71, 104)]
struct ITextRange
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(1537101399, 49266, 17056, 137, 69, 175, 80, 62, 229, 71, 104)]
public interface ITextRange
Public Interface ITextRange
Abgeleitet
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Eigenschaften

Character

Ruft das erste Zeichen des Textbereichs ab oder legt es fest. d. h. das Zeichen, das der StartPosition-Eigenschaft zugeordnet ist.

CharacterFormat

Ruft die Zeichenformatierungsattribute des Textbereichs ab oder legt diese fest.

EndPosition

Ruft die Endzeichenposition des Textbereichs ab oder legt diese fest.

FormattedText

Ruft ein ITextRange-Objekt mit dem formatierten Text des angegebenen Bereichs ab oder legt es fest.

Gravity

Ruft die Schwerkraft des Textbereichs ab oder legt diese fest.

Length

Ruft die Anzahl der Zeichen im Textbereich ab.

Link

Ruft den URL-Text ab, der einem Textbereich zugeordnet ist, oder legt diese fest.

ParagraphFormat

Ruft die Absatzformatierungsattribute des Textbereichs ab oder legt diese fest.

StartPosition

Ruft die Startposition des Textbereichs ab oder legt diese fest.

StoryLength

Ruft die Anzahl der Zeichen im Textbereich ab.

Text

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

Methoden

CanPaste(Int32)

Bestimmt, ob die Zwischenablage Inhalte enthält, die in einem angegebenen Format in den aktuellen Textbereich eingefügt werden können.

ChangeCase(LetterCase)

Ändert die Groß-/Kleinschreibung von Buchstaben in einem Textbereich.

Collapse(Boolean)

Reduziert den Textbereich entweder am Anfang oder am Ende des Bereichs in einen entarteten Punkt.

Copy()

Kopiert den Text des Textbereichs in die Zwischenablage.

Cut()

Verschiebt den Text des Textbereichs in die Zwischenablage.

Delete(TextRangeUnit, Int32)

Löscht Text aus dem Textbereich.

EndOf(TextRangeUnit, Boolean)

Verschiebt oder erweitert den Textbereich an das Ende der nächstgelegenen angegebenen Texteinheit. Der Textbereich wird im Dokument nach vorne verschoben oder erweitert.

Expand(TextRangeUnit)

Erweitert einen Textbereich so, dass er alle Teiltexteinheiten vollständig enthält.

FindText(String, Int32, FindOptions)

Sucht nach einer bestimmten Textzeichenfolge in einem Bereich und wählt die Zeichenfolge aus, wenn sie gefunden wird.

GetCharacterUtf32(UInt32, Int32)

Ruft den Utf-Code (Unicode Transformation Format) mit 32 Zeichen des Zeichens am angegebenen Offset vom Ende des Textbereichs ab.

GetClone()

Erstellt ein neues Objekt, das mit diesem Textbereichsobjekt identisch ist.

GetIndex(TextRangeUnit)

Ruft den Textabschnittsindex der Texteinheit (Wort, Zeile, Satz, Absatz usw.) an der Anfangszeichenposition des Textbereichs ab.

GetPoint(HorizontalCharacterAlignment, VerticalCharacterAlignment, PointOptions, Point)

Ruft die Bildschirmkoordinaten einer bestimmten Position im Textbereich ab.

GetRect(PointOptions, Rect, Int32)

Ruft das umgebende Rechteck ab, das den Textbereich auf dem Bildschirm umfasst.

GetText(TextGetOptions, String)

Ruft den Text in einem Textbereich gemäß den angegebenen Konvertierungsflags ab.

GetTextViaStream(TextGetOptions, IRandomAccessStream)

Ruft den Text im Textbereich gemäß den angegebenen Konvertierungsflags als Datenstrom mit zufälligem Zugriff ab.

InRange(ITextRange)

Bestimmt, ob sich dieser Bereich im oder im selben Text wie ein angegebener Bereich befindet.

InsertImage(Int32, Int32, Int32, VerticalCharacterAlignment, String, IRandomAccessStream)

Fügt ein Bild in diesen Bereich ein.

InStory(ITextRange)

Bestimmt, ob die Geschichte dieses Bereichs mit der Geschichte eines angegebenen Bereichs identisch ist.

IsEqual(ITextRange)

Bestimmt, ob dieser Bereich die gleichen Zeichenpositionen und die gleiche Geschichte wie die eines angegebenen Bereichs aufweist.

MatchSelection()

Legt die Start- und Endposition dieses Bereichs so fest, dass sie der aktiven Auswahl entsprechen.

Move(TextRangeUnit, Int32)

Verschiebt die Einfügemarke um die angegebene Anzahl von Einheiten nach vorne oder rückwärts. Wenn der Textbereich nicht entgeneriert ist, wird er je nach Anzahl auf eine Einfügemarke an der Anfangs- oder Endposition des Textbereichs reduziert und dann verschoben.

MoveEnd(TextRangeUnit, Int32)

Verschiebt die Endposition des Textbereichs.

MoveStart(TextRangeUnit, Int32)

Verschiebt die Startposition eines Textbereichs.

Paste(Int32)

Fügt Text aus der Zwischenablage in den Textbereich ein.

ScrollIntoView(PointOptions)

Scrollt diesen Textbereich in die Ansicht.

SetIndex(TextRangeUnit, Int32, Boolean)

Verschiebt den Textbereich in die angegebene Einheit des Storys.

SetPoint(Point, PointOptions, Boolean)

Ändert den Textbereich basierend auf dem angegebenen Punkt.

SetRange(Int32, Int32)

Legt die Endpunkte des Textbereichs auf die angegebenen Werte fest.

SetText(TextSetOptions, String)

Ersetzt den Text im Textbereich.

SetTextViaStream(TextSetOptions, IRandomAccessStream)

Legt den Text im Textbereich basierend auf dem Inhalt eines Datenstroms mit zufälligem Zugriff fest.

StartOf(TextRangeUnit, Boolean)

Verschiebt oder erweitert den Textbereich bis zum Anfang der nächstgelegenen angegebenen Texteinheit. Der Textbereich wird im Dokument rückwärts verschoben oder erweitert.

Gilt für: