TextRange Osztály

Definíció

Névtér:

System.Windows.Documents

Szerelvény:

PresentationFramework.dll

Két pozíció közötti TextPointer tartalomválasztást jelöl.

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

Öröklődés

Object

TextRange

Származtatott

System.Windows.Documents.TextSelection

Példák

Az alábbi példa bemutatja, hogy az Text a TextRange tulajdonság használatával adja vissza egy adott FlowDocumentszöveg egyszerű szöveges ábrázolását.

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

Megjegyzések

Az TextRange osztály a következő terminológiát mutatja be.

• Kijelölés – Az A TextRange a szövegpontok által jelzett két pozíció közötti tartalom kiválasztása. Ezek egyike rögzített horgonyt helyez el a kijelölés tekintetében, míg a másik pozíció mozgatható. Ez hasonló ahhoz, ahogyan egy felhasználó által az egérrel vagy billentyűzettel végzett kijelölés viselkedik.

• Aktuális kijelölés – Mivel a TextRange tartalomban mindig kijelölést jelöl, érdemes egyszerűen az TextRange megjelölt kijelölésre hivatkozni.

• Szövegtároló – A szövegtároló az az elem, amely a folyamatban lévő folyamattartalom végső szegélyét képezi; a kijelölt elem TextRange mindig egy szövegtárolóba esik. A szövegtárolóknak jelenleg egy FlowDocument vagy egynek kell lenniük TextBlock.

• Dokumentum – A szövegtárolóban együttesen található tartalmat dokumentumnak nevezzük.

További információ az egyéb kapcsolódó kifejezésekről, például a pozícióról: TextPointer.

Konstruktorok

Name	Description
TextRange(TextPointer, TextPointer)	Inicializálja az TextRange osztály új példányát, és két megadott TextPointer pozíciót vesz fel az új tartomány kezdő és záró pozíciójaként.

Tulajdonságok

Name	Description
End	Az aktuális kijelölés végét jelző pozíció lekérése.
IsEmpty	Beolvas egy értéket, amely jelzi, hogy az aktuális kijelölés üres-e.
Start	Lekéri az aktuális kijelölés elejét jelző pozíciót.
Text	Lekéri vagy beállítja az aktuális kijelölés egyszerű szöveges tartalmát.

Metódusok

Name	Description
ApplyPropertyValue(DependencyProperty, Object)	Megadott formázási tulajdonságot és értéket alkalmaz az aktuális kijelölésre.
CanLoad(String)	Ellenőrzi, hogy az aktuális kijelölés betölthető-e adott adatformátumú tartalommal.
CanSave(String)	Ellenőrzi, hogy az aktuális kijelölés menthető-e megadott adatformátumként.
ClearAllProperties()	Eltávolítja az összes formázási tulajdonságot (amelyeket Inline elemek jelölnek) az aktuális kijelölésből.
Contains(TextPointer)	Ellenőrzi, hogy a ( TextPointermegadott) pozíció az aktuális kijelölésen belül található-e.
GetPropertyValue(DependencyProperty)	Egy megadott formázási tulajdonság tényleges értékét adja vissza az aktuális kijelölésen.
Load(Stream, String)	Betölti az aktuális kijelölést egy megadott adatformátumban egy adott streamből.
Save(Stream, String, Boolean)	Az aktuális kijelölést egy megadott adatformátumban menti egy adott adatfolyamba, egyéni objektumok megőrzésének TextElement lehetőségével.
Save(Stream, String)	Az aktuális kijelölést egy megadott adatfolyamba menti egy megadott adatformátumban.
Select(TextPointer, TextPointer)	Frissíti az aktuális kijelölést, és két TextPointer pozícióval jelzi a frissített kijelölést.

esemény

Name	Description
Changed	Akkor fordul elő, ha a tartományt áthelyezik, hogy lefedje a tartalom egy új hatókörét.

Lásd még

• TextPointerContext