TextRange Klas

Definitie

Vertegenwoordigt een selectie van inhoud tussen twee TextPointer posities.

public ref class TextRange
public class TextRange
type TextRange = class
Public Class TextRange
Overname
TextRange
Afgeleid

Voorbeelden

In het volgende voorbeeld ziet u hoe u de Text eigenschap van een object TextRange gebruikt om de weergave van een opgegeven FlowDocumenttekst zonder opmaak te retourneren.

// 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

Opmerkingen

De TextRange klasse introduceert de volgende terminologie.

  • Selectie : A TextRange is een selectie van inhoud tussen twee posities die worden aangegeven door TextPointers. Een van deze posities is een vast anker met betrekking tot de selectie, terwijl de andere positie beweegbaar is. Dit is vergelijkbaar met hoe een selectie van een gebruiker die de muis of het toetsenbord gebruikt, zich gedraagt.

  • Huidige selectie : omdat een TextRange selectie altijd in inhoud aangeeft, is het zinvol om gewoon naar de selectie te verwijzen die wordt aangegeven door een TextRange als de huidige selectie.

  • Text Container - Een tekstcontainer is het element dat de ultieme rand vormt voor de stroominhoud die bij de hand is; de selectie die wordt aangegeven door een TextRange tekstcontainer, valt altijd binnen een tekstcontainer. Op dit moment moet een tekstcontainer een FlowDocument of een TextBlock.

  • Document : de inhoud die gezamenlijk in een tekstcontainer is opgenomen, wordt een document genoemd.

Zie voor meer informatie over andere gerelateerde termen, zoals positie.TextPointer

Constructors

Name Description
TextRange(TextPointer, TextPointer)

Initialiseert een nieuw exemplaar van de TextRange klasse, waarbij twee opgegeven posities worden gebruikt TextPointer als de begin- en eindposities voor het nieuwe bereik.

Eigenschappen

Name Description
End

De positie ophalen die het einde van de huidige selectie markeert.

IsEmpty

Hiermee wordt een waarde opgehaald die aangeeft of de huidige selectie leeg is.

Start

Hiermee haalt u de positie op waarmee het begin van de huidige selectie wordt gemarkeerd.

Text

Hiermee haalt u de tekst zonder opmaak van de huidige selectie op of stelt u deze in.

Methoden

Name Description
ApplyPropertyValue(DependencyProperty, Object)

Hiermee past u een opgegeven opmaakeigenschap en -waarde toe op de huidige selectie.

CanLoad(String)

Hiermee wordt gecontroleerd of de huidige selectie kan worden geladen met inhoud in een opgegeven gegevensindeling.

CanSave(String)

Hiermee wordt gecontroleerd of de huidige selectie kan worden opgeslagen als een opgegeven gegevensindeling.

ClearAllProperties()

Hiermee verwijdert u alle opmaakeigenschappen (vertegenwoordigd door Inline elementen) uit de huidige selectie.

Contains(TextPointer)

Hiermee wordt gecontroleerd of een positie (opgegeven door een TextPointer) zich binnen de huidige selectie bevindt.

Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetPropertyValue(DependencyProperty)

Retourneert de effectieve waarde van een opgegeven opmaakeigenschap voor de huidige selectie.

GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
Load(Stream, String)

Laadt de huidige selectie in een opgegeven gegevensindeling vanuit een opgegeven stroom.

MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
Save(Stream, String, Boolean)

Hiermee wordt de huidige selectie opgeslagen in een opgegeven stroom in een opgegeven gegevensindeling, met de optie om aangepaste TextElement objecten te behouden.

Save(Stream, String)

Hiermee wordt de huidige selectie opgeslagen in een opgegeven stroom in een opgegeven gegevensindeling.

Select(TextPointer, TextPointer)

Hiermee wordt de huidige selectie bijgewerkt, waarbij twee TextPointer posities worden gebruikt om de bijgewerkte selectie aan te geven.

ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

gebeurtenis

Name Description
Changed

Treedt op wanneer het bereik wordt verplaatst om een nieuw inhoudsbereik te dekken.

Van toepassing op

Zie ook