TextRange Klasse

Definition

Stellt eine Inhaltsauswahl zwischen zwei TextPointer-Positionen dar.Represents a selection of content between two TextPointer positions.

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

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Text-Eigenschaft eines TextRange verwendet wird, um die nur-Text-Darstellung eines angegebenen FlowDocumentzurückzugeben.The following example demonstrates using the Text property of a TextRange to return the plain text representation of a specified FlowDocument.

// 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.The TextRange class introduces the following terminology.

  • Auswahl : eine TextRange ist eine Auswahl von Inhalten zwischen zwei von Text Zeigerngekennzeichneten Positionen.Selection - A TextRange is a selection of content between two positions indicated by TextPointers. Eine dieser Positionen positioniert einen Fixed-Anker in Bezug auf die Auswahl, während die andere Position verschiebbar ist.One of these positions a fixed anchor with respect to the selection, while the other position is movable. Dies ähnelt der Art und Weise, wie sich ein Benutzer mit der Maus oder der Tastatur verhält.This is similar to how a selection made by a user using the mouse or keyboard behaves.

  • Aktuelle Auswahl : da ein TextRange immer eine Auswahl im Inhalt anzeigt, ist es sinnvoll, einfach auf die Auswahl zu verweisen, die durch eine TextRange als aktuelle Auswahlangegeben wird.Current Selection - Because a TextRange always indicates a selection in content, it makes sense to simply refer to the selection indicated by a TextRange as the current selection.

  • Text Container : ein Text Container ist das Element, das den endgültigen Rahmen für den Flow-Inhalt bildet. die Auswahl, die von einem TextRange angegeben wird, liegt immer innerhalb eines Text Containers.Text Container - A text container is the element that forms the ultimate border for the flow content at hand; the selection indicated by a TextRange always falls within a text container. Derzeit muss ein Text Container entweder eine FlowDocument oder eine TextBlocksein.Currently, a text container must be either a FlowDocument or a TextBlock.

  • Dokument -der Inhalt, der in einem Text Container Kollektiv enthalten ist, wird als Dokumentbezeichnet.Document - The content collectively contained within a text container is referred to as a document.

Weitere Informationen zu anderen verwandten Begriffen, wie z. b. Position, finden Sie unter TextPointer.For more information about other related terms like position, see 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.Initializes a new instance of the TextRange class, taking two specified TextPointer positions as the beginning and end positions for the new range.

Eigenschaften

End

Rufen Sie die Position ab, die das Ende der aktuellen Auswahl markiert.Get the position that marks the end of the current selection.

IsEmpty

Ruft einen Wert ab, der angibt, ob die aktuelle Auswahl leer ist.Gets a value indicating whether or not the current selection is empty.

Start

Ruft die Position ab, die den Anfang der aktuellen Auswahl markiert.Gets the position that marks the beginning of the current selection.

Text

Ruft den Nur-Text-Inhalt der aktuellen Auswahl ab oder legt diesen fest.Gets or sets the plain text contents of the current selection.

Methoden

ApplyPropertyValue(DependencyProperty, Object)

Wendet auf die aktuelle Auswahl eine angegebene Formatierungseigenschaft und einen Wert an.Applies a specified formatting property and value to the current selection.

CanLoad(String)

Überprüft, ob die aktuelle Auswahl mit Inhalt in ein angegebenes Datenformat geladen werden kann.Checks whether the current selection can be loaded with content in a specified data format.

CanSave(String)

Überprüft, ob die aktuelle Auswahl in einem angegebenen Datenformat gespeichert werden kann.Checks whether the current selection can be saved as a specified data format.

ClearAllProperties()

Entfernt alle Formatierungseigenschaften (durch Inline-Elemente dargestellt) aus der aktuellen Auswahl.Removes all formatting properties (represented by Inline elements) from the current selection.

Contains(TextPointer)

Überprüft, ob sich eine Position (von einem TextPointer angegeben) innerhalb der aktuellen Auswahl befindet.Checks whether a position (specified by a TextPointer) is located within the current selection.

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetPropertyValue(DependencyProperty)

Gibt den effektiven Wert einer angegebenen Formatierungseigenschaft für die aktuelle Auswahl zurück.Returns the effective value of a specified formatting property on the current selection.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
Load(Stream, String)

Lädt die aktuelle Auswahl aus einem angegebenen Stream in ein angegebenes Datenformat.Loads the current selection in a specified data format from a specified stream.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
Save(Stream, String)

Speichert die aktuelle Auswahl in einem angegebenen Stream in einem angegebenen Datenformat.Saves the current selection to a specified stream in a specified data format.

Save(Stream, String, Boolean)

Speichert die aktuelle Auswahl in einem angegebenen Stream in einem angegebenen Datenformat. Optional können benutzerdefinierte TextElement-Objekte beibehalten werden.Saves the current selection to a specified stream in a specified data format, with the option of preserving custom TextElement objects.

Select(TextPointer, TextPointer)

Aktualisiert die aktuelle Auswahl, indem zwei TextPointer-Positionen zum Angeben der aktualisierten Auswahl verwendet werden.Updates the current selection, taking two TextPointer positions to indicate the updated selection.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Ereignisse

Changed

Tritt auf, wenn der Bereich neu positioniert wurde, um einen neuen Inhaltsbereich abzudecken.Occurs when the range is repositioned to cover a new span of content.

Gilt für:

Siehe auch