TextRange Klasa

Definicja

Przestrzeń nazw:

System.Windows.Documents

Zestaw:

PresentationFramework.dll

Reprezentuje wybór zawartości między dwoma TextPointer pozycjami.

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

Dziedziczenie

Object

TextRange

Pochodne

System.Windows.Documents.TextSelection

Przykłady

W poniższym przykładzie pokazano użycie Text właściwości elementu TextRange , aby zwrócić reprezentację w postaci zwykłego tekstu określonego FlowDocumentelementu .

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

Uwagi

Klasa TextRange wprowadza następującą terminologię.

• Wybór — element to TextRange wybór zawartości między dwoma pozycjami wskazywanym przez program TextPointers. Jedna z tych pozycji stała kotwica w odniesieniu do zaznaczenia, podczas gdy druga pozycja jest wymienna. Jest to podobne do zachowania wyboru dokonanego przez użytkownika za pomocą myszy lub klawiatury.

• Bieżące zaznaczenie — ponieważ TextRange zawsze wskazuje wybór w zawartości, warto po prostu odwoływać się do zaznaczenia wskazanego przez TextRange element jako bieżące zaznaczenie.

• Kontener tekstu — kontener tekstowy jest elementem, który stanowi ostateczne obramowanie zawartości przepływu; zaznaczenie wskazane przez element TextRange zawsze mieści się w kontenerze tekstowym. Obecnie kontener tekstowy musi być kontenerem FlowDocument TextBlocklub .

• Document — zawartość zbiorczo zawarta w kontenerze tekstowym jest określana jako dokument.

Aby uzyskać więcej informacji na temat innych powiązanych terminów, takich jak pozycja, zobacz TextPointer.

Konstruktory

TextRange(TextPointer, TextPointer)

Inicjuje TextRange nowe wystąpienie klasy, przyjmując dwa określone TextPointer pozycje jako pozycje początkowe i końcowe dla nowego zakresu.

Właściwości

End	Pobierz pozycję, która oznacza koniec bieżącego zaznaczenia.
IsEmpty	Pobiera wartość wskazującą, czy bieżące zaznaczenie jest puste.
Start	Pobiera pozycję, która oznacza początek bieżącego zaznaczenia.
Text	Pobiera lub ustawia zawartość zwykłego tekstu bieżącego zaznaczenia.

Metody

ApplyPropertyValue(DependencyProperty, Object)	Stosuje określoną właściwość formatowania i wartość do bieżącego zaznaczenia.
CanLoad(String)	Sprawdza, czy bieżące zaznaczenie można załadować z zawartością w określonym formacie danych.
CanSave(String)	Sprawdza, czy bieżące zaznaczenie można zapisać jako określony format danych.
ClearAllProperties()	Usuwa wszystkie właściwości formatowania (reprezentowane przez Inline elementy) z bieżącego zaznaczenia.
Contains(TextPointer)	Sprawdza, czy pozycja (określona przez ) TextPointerznajduje się w bieżącym zaznaczeniu.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetPropertyValue(DependencyProperty)	Zwraca efektywną wartość określonej właściwości formatowania w bieżącym zaznaczeniu.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
Load(Stream, String)	Ładuje bieżące zaznaczenie w określonym formacie danych z określonego strumienia.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Save(Stream, String)	Zapisuje bieżące zaznaczenie w określonym strumieniu w określonym formacie danych.
Save(Stream, String, Boolean)	Zapisuje bieżące zaznaczenie w określonym strumieniu w określonym formacie danych z opcją zachowania obiektów niestandardowych TextElement .
Select(TextPointer, TextPointer)	Aktualizuje bieżące zaznaczenie, biorąc dwie TextPointer pozycje, aby wskazać zaktualizowany wybór.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

Changed

Występuje, gdy zakres jest zmieniany w celu pokrycia nowego zakresu zawartości.

Zobacz też

• TextPointerContext