TextRange Klass

Definition

Representerar ett urval av innehåll mellan två TextPointer positioner.

public ref class TextRange
public class TextRange
type TextRange = class
Public Class TextRange
Arv
TextRange
Härledda

Exempel

I följande exempel visas hur du använder Text egenskapen för en TextRange för att returnera oformaterad textrepresentation av en angiven 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

Kommentarer

Klassen TextRange introducerar följande terminologi.

  • Markering – A TextRange är ett urval av innehåll mellan två positioner som anges av TextPointers. En av dessa positionerar ett fast fästpunkt med avseende på valet, medan den andra positionen kan flyttas. Detta liknar hur ett val som görs av en användare med hjälp av musen eller tangentbordet fungerar.

  • Aktuell markering – Eftersom en TextRange alltid anger en markering i innehåll är det klokt att bara referera till markeringen som anges av en TextRange som aktuell markering.

  • Textcontainer – en textcontainer är det element som utgör den ultimata kantlinjen för det aktuella flödesinnehållet. markeringen som anges av en TextRange faller alltid inom en textcontainer. För närvarande måste en textcontainer vara antingen en FlowDocument eller en TextBlock.

  • Dokument – Innehållet som samlas i en textcontainer kallas för ett dokument.

Mer information om andra relaterade termer som position finns i TextPointer.

Konstruktorer

Name Description
TextRange(TextPointer, TextPointer)

Initierar en ny instans av TextRange klassen och tar två angivna TextPointer positioner som start- och slutpositioner för det nya intervallet.

Egenskaper

Name Description
End

Hämta den position som markerar slutet på den aktuella markeringen.

IsEmpty

Hämtar ett värde som anger om den aktuella markeringen är tom eller inte.

Start

Hämtar den position som markerar början av den aktuella markeringen.

Text

Hämtar eller anger oformaterad text i den aktuella markeringen.

Metoder

Name Description
ApplyPropertyValue(DependencyProperty, Object)

Tillämpar en angiven formateringsegenskap och värde på den aktuella markeringen.

CanLoad(String)

Kontrollerar om den aktuella markeringen kan läsas in med innehåll i ett angivet dataformat.

CanSave(String)

Kontrollerar om den aktuella markeringen kan sparas som ett angivet dataformat.

ClearAllProperties()

Tar bort alla formateringsegenskaper (representeras av Inline element) från den aktuella markeringen.

Contains(TextPointer)

Kontrollerar om en position (angiven av en TextPointer) finns inom den aktuella markeringen.

Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetPropertyValue(DependencyProperty)

Returnerar det effektiva värdet för en angiven formateringsegenskap för den aktuella markeringen.

GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
Load(Stream, String)

Läser in den aktuella markeringen i ett angivet dataformat från en angiven ström.

MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
Save(Stream, String, Boolean)

Sparar den aktuella markeringen till en angiven ström i ett angivet dataformat, med alternativet att bevara anpassade TextElement objekt.

Save(Stream, String)

Sparar den aktuella markeringen till en angiven ström i ett angivet dataformat.

Select(TextPointer, TextPointer)

Uppdaterar den aktuella markeringen och tar två TextPointer positioner för att ange den uppdaterade markeringen.

ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Händelser

Name Description
Changed

Inträffar när intervallet flyttas för att täcka ett nytt innehållsintervall.

Gäller för

Se även