TextRange Třída

Definice

Obor názvů:

System.Windows.Documents

Sestavení:

PresentationFramework.dll

Představuje výběr obsahu mezi dvěma TextPointer pozicemi.

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

Dědičnost

Object

TextRange

Odvozené

System.Windows.Documents.TextSelection

Příklady

Následující příklad ukazuje použití Text vlastnosti k vrácení reprezentace prostého TextRange textu zadaného 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

Poznámky

Třída TextRange představuje následující terminologii.

• Výběr – A TextRange je výběr obsahu mezi dvěma pozicemi označenými textovými body. Jedna z těchto pozic je pevná kotva s ohledem na výběr, zatímco druhá pozice je pohyblivá. Podobá se tomu, jak se chová výběr provedený uživatelem pomocí myši nebo klávesnice.

• Aktuální výběr – Protože TextRange vždy označuje výběr v obsahu, dává smysl jednoduše odkazovat na výběr označený TextRange jako aktuální výběr.

• Kontejner textu – textový kontejner je prvek, který tvoří konečné ohraničení obsahu toku. výběr označený TextRange vždy spadá do textového kontejneru. V současné době musí být textový kontejner buď a FlowDocument nebo .TextBlock

• Dokument – obsah, který se souhrnně nachází v textovém kontejneru, se označuje jako dokument.

Další informace o dalších souvisejících termínech, jako je pozice, naleznete v tématu TextPointer.

Konstruktory

TextRange(TextPointer, TextPointer)

Inicializuje novou instanci TextRange třídy a vezme dvě zadané TextPointer pozice jako počáteční a koncové pozice pro nový rozsah.

Vlastnosti

End	Získejte pozici, která označuje konec aktuálního výběru.
IsEmpty	Získá hodnotu určující, zda aktuální výběr je prázdný.
Start	Získá pozici, která označuje začátek aktuálního výběru.
Text	Získá nebo nastaví obsah prostého textu aktuálního výběru.

Metody

ApplyPropertyValue(DependencyProperty, Object)	Použije zadanou vlastnost formátování a hodnotu pro aktuální výběr.
CanLoad(String)	Zkontroluje, jestli je možné aktuální výběr načíst s obsahem v zadaném formátu dat.
CanSave(String)	Zkontroluje, jestli je možné aktuální výběr uložit jako zadaný formát dat.
ClearAllProperties()	Odebere z aktuálního výběru všechny vlastnosti formátování (reprezentované Inline prvky).
Contains(TextPointer)	Zkontroluje, zda je pozice (určená znakem TextPointer) umístěna v aktuálním výběru.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetPropertyValue(DependencyProperty)	Vrátí efektivní hodnotu zadané vlastnosti formátování aktuálního výběru.
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
Load(Stream, String)	Načte aktuální výběr v zadaném datovém formátu ze zadaného datového proudu.
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
Save(Stream, String)	Uloží aktuální výběr do zadaného datového proudu v zadaném formátu dat.
Save(Stream, String, Boolean)	Uloží aktuální výběr do zadaného datového proudu v zadaném formátu dat s možností zachování vlastních TextElement objektů.
Select(TextPointer, TextPointer)	Aktualizuje aktuální výběr a má dvě TextPointer pozice, které označují aktualizovaný výběr.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

událost

Changed

Nastane, když je oblast přemísťována tak, aby zahrnovala nový rozsah obsahu.

Viz také

• TextPointerContext