Freigeben über

TextRange Klasse

Definition

Namespace:
System.Windows.Documents
Assembly:
PresentationFramework.dll

Stellt eine Auswahl des Inhalts zwischen zwei TextPointer Positionen dar.

public ref class TextRange
public class TextRange
type TextRange = class
Public Class TextRange
Vererbung
Object
TextRange
Abgeleitet

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der Text Eigenschaft einer TextRange , um die Nur-Text-Darstellung einer angegebenen FlowDocumentzurückzugeben.

// This method returns a plain text representation of a specified FlowDocument.
string GetTextFromFlowDocument(FlowDocument flowDoc)
{
     // Create a new TextRanage that takes the entire FlowDocument as the current selection.
     TextRange flowDocSelection = new TextRange(flowDoc.ContentStart, flowDoc.ContentEnd);
      
     // Use the Text property to extract a string that contains the unformatted text contents 
     // of the FlowDocument.
     return flowDocSelection.Text;
}

' This method returns a plain text representation of a specified FlowDocument.
Private Function GetTextFromFlowDocument(ByVal flowDoc As FlowDocument) As String
    ' Create a new TextRanage that takes the entire FlowDocument as the current selection.
    Dim flowDocSelection As New TextRange(flowDoc.ContentStart, flowDoc.ContentEnd)

    ' Use the Text property to extract a string that contains the unformatted text contents 
    ' of the FlowDocument.
    Return flowDocSelection.Text
End Function

Hinweise

Die TextRange Klasse führt die folgende Terminologie ein.

  • Auswahl – A TextRange ist eine Auswahl von Inhalten zwischen zwei Positionen, die von TextPointern angegeben werden. Eine dieser Positionen ist ein fester Anker in Bezug auf die Auswahl, während die andere Position verschiebbar ist. Dies ähnelt dem Verhalten einer Auswahl durch einen Benutzer, der die Maus oder Tastatur verwendet.

  • Aktuelle Auswahl – Da immer TextRange eine Auswahl im Inhalt angezeigt wird, ist es sinnvoll, einfach auf die durch eine TextRangeals aktuelle Auswahl angegebene Auswahl zu verweisen.

  • Textcontainer – Ein Textcontainer ist das Element, das den ultimativen Rahmen für den von Hand stehenden Flussinhalt bildet; die durch einen TextRange Textcontainer angegebene Auswahl immer in einen Textcontainer fällt. Derzeit muss ein Textcontainer entweder ein FlowDocument oder ein TextBlockTextcontainer sein.

  • Dokument – Der in einem Textcontainer enthaltene Inhalt wird als Dokument bezeichnet.

Weitere Informationen zu anderen verwandten Begriffen wie Position finden Sie unter TextPointer.

Konstruktoren

Name Beschreibung
TextRange(TextPointer, TextPointer)

Initialisiert eine neue Instanz der TextRange Klasse, wobei zwei angegebene Positionen als Anfangs- und Endpositionen für den neuen Bereich verwendet TextPointer werden.

Eigenschaften

Name Beschreibung
End

Ruft die Position ab, die das Ende der aktuellen Auswahl markiert.
IsEmpty

Ruft einen Wert ab, der angibt, ob die aktuelle Auswahl leer ist.
Start

Ruft die Position ab, die den Anfang der aktuellen Auswahl markiert.
Text

Dient zum Abrufen oder Festlegen des Nur-Text-Inhalts der aktuellen Auswahl.

Methoden

Name Beschreibung
ApplyPropertyValue(DependencyProperty, Object)

Wendet eine angegebene Formatierungseigenschaft und einen angegebenen Wert auf die aktuelle Auswahl an.
CanLoad(String)

Überprüft, ob die aktuelle Auswahl mit Inhalt in einem angegebenen Datenformat geladen werden kann.
CanSave(String)

Überprüft, ob die aktuelle Auswahl als angegebenes Datenformat gespeichert werden kann.
ClearAllProperties()

Entfernt alle Formatierungseigenschaften (dargestellt durch Inline Elemente) aus der aktuellen Auswahl.
Contains(TextPointer)

Überprüft, ob sich eine Position (angegeben durch a TextPointer) innerhalb der aktuellen Auswahl befindet.
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetPropertyValue(DependencyProperty)

Gibt den effektiven Wert einer angegebenen Formatierungseigenschaft für die aktuelle Auswahl zurück.
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
Load(Stream, String)

Lädt die aktuelle Auswahl in einem angegebenen Datenformat aus einem angegebenen Datenstrom.
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
Save(Stream, String, Boolean)

Speichert die aktuelle Markierung in einem angegebenen Datenstrom in einem angegebenen Datenformat, mit der Möglichkeit, benutzerdefinierte TextElement Objekte beizubehalten.
Save(Stream, String)

Speichert die aktuelle Auswahl in einem angegebenen Datenstrom in einem angegebenen Datenformat.
Select(TextPointer, TextPointer)

Aktualisiert die aktuelle Auswahl, wobei zwei TextPointer Positionen verwendet werden, um die aktualisierte Auswahl anzugeben.
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Ereignisse

Name Beschreibung
Changed

Tritt auf, wenn der Bereich neu positioniert wird, um einen neuen Bereich von Inhalten abzudecken.

Gilt für:

Weitere Informationen