TextRange Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine Inhaltsauswahl zwischen zwei TextPointer-Positionen dar.
public ref class TextRange
public class TextRange
type TextRange = class
Public Class TextRange
- Vererbung
-
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 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. |