TextRange Klasse

Definition

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Stellt eine Inhaltsauswahl zwischen zwei TextPointer-Positionen dar.

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

Vererbung

Object

TextRange

Abgeleitet

System.Windows.Documents.TextSelection

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 mit der Maus oder Tastatur.

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

• Textcontainer – Ein Textcontainer ist das Element, das den ultimativen Rahmen für den flussbezogenen Inhalt bildet; die durch einen TextRange Textcontainer angegebene Markierung immer in einen Textcontainer fällt. Derzeit muss ein Textcontainer entweder ein oder ein FlowDocument .TextBlock

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

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

Konstruktoren

TextRange(TextPointer, TextPointer)

Initialisiert eine neue Instanz der TextRange-Klasse mit zwei angegebenen TextPointer-Positionen als Anfangs- und Endpositionen für den neuen Bereich.

Eigenschaften

End	Rufen Sie 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	Ruft den Nur-Text-Inhalt der aktuellen Auswahl ab oder legt diesen fest.

Methoden

ApplyPropertyValue(DependencyProperty, Object)	Wendet auf die aktuelle Auswahl eine angegebene Formatierungseigenschaft und einen Wert an.
CanLoad(String)	Überprüft, ob die aktuelle Auswahl mit Inhalt in ein angegebenes Datenformat geladen werden kann.
CanSave(String)	Überprüft, ob die aktuelle Auswahl in einem angegebenen Datenformat gespeichert werden kann.
ClearAllProperties()	Entfernt alle Formatierungseigenschaften (durch Inline-Elemente dargestellt) aus der aktuellen Auswahl.
Contains(TextPointer)	Überprüft, ob sich eine Position (von einem TextPointer angegeben) innerhalb der aktuellen Auswahl befindet.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetPropertyValue(DependencyProperty)	Gibt den effektiven Wert einer angegebenen Formatierungseigenschaft für die aktuelle Auswahl zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Load(Stream, String)	Lädt die aktuelle Auswahl aus einem angegebenen Stream in ein angegebenes Datenformat.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Save(Stream, String)	Speichert die aktuelle Auswahl in einem angegebenen Stream in einem angegebenen Datenformat.
Save(Stream, String, Boolean)	Speichert die aktuelle Auswahl in einem angegebenen Stream in einem angegebenen Datenformat. Optional können benutzerdefinierte TextElement-Objekte beibehalten werden.
Select(TextPointer, TextPointer)	Aktualisiert die aktuelle Auswahl, indem zwei TextPointer-Positionen zum Angeben der aktualisierten Auswahl verwendet werden.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

Changed

Tritt auf, wenn der Bereich neu positioniert wurde, um einen neuen Inhaltsbereich abzudecken.

Siehe auch

• TextPointerContext