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 vlastnost TextRange vrátit reprezentaci prostého 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 zavádí následující terminologii.

• výběr – TextRange je výběr obsahu mezi dvěma pozicemi označenými textpointery. 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.

• textový kontejner – textový kontejner je prvek, který tvoří konečný okraj obsahu toku. výběr označený vždy spadá do textového kontejneru. V současné době musí být textový kontejner buď 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 jsou pozice, naleznete v tématu TextPointer.

Konstruktory

TextRange(TextPointer, TextPointer)

Inicializuje novou instanci TextRange třídy, přičemž dva 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é prvky Inline).
Contains(TextPointer)	Zkontroluje, zda je pozice (určená TextPointer) umístěna v aktuálním výběru.
Equals(Object)	Určuje, zda je zadaný objekt roven 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()	Získá Type aktuální instance. (Zděděno od Object)
Load(Stream, String)	Načte aktuální výběr v zadaném formátu dat ze zadaného datového proudu.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
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 objektů TextElement.
Save(Stream, String)	Uloží aktuální výběr do zadaného datového proudu v zadaném formátu dat.
Select(TextPointer, TextPointer)	Aktualizuje aktuální výběr tak, že vezme 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 pokrývala nové rozpětí obsahu.

Viz také

• TextPointerContext