TextRange Classe

Definizione

Spazio dei nomi:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Rappresenta una selezione di contenuto tra due posizioni dell'oggetto TextPointer.

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

Ereditarietà

Object

TextRange

Derivato

System.Windows.Documents.TextSelection

Esempio

Nell'esempio seguente viene illustrato l'uso della proprietà di un TextRange oggetto per restituire la Text rappresentazione di testo normale di un oggetto specificatoFlowDocument.

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

Commenti

La TextRange classe introduce la terminologia seguente.

• Selezione : una TextRange selezione del contenuto tra due posizioni indicate da TextPointers. Una di queste posizioni è un ancoraggio fisso rispetto alla selezione, mentre l'altra posizione è rimovibile. Si tratta di un comportamento simile a quello di una selezione effettuata da un utente che usa il mouse o la tastiera.

• Selezione corrente : poiché un TextRange oggetto indica sempre una selezione nel contenuto, è consigliabile fare semplicemente riferimento alla selezione indicata da una TextRange come selezione corrente.

• Contenitore di testo: un contenitore di testo è l'elemento che forma il bordo finale per il contenuto del flusso a mano; la selezione indicata da un oggetto rientra sempre all'interno di un TextRange contenitore di testo. Attualmente, un contenitore di testo deve essere un FlowDocument oggetto o un TextBlockoggetto .

• Documento : il contenuto contenuto collettivamente contenuto all'interno di un contenitore di testo viene definito documento.

Per altre informazioni su altri termini correlati come posizione, vedere TextPointer.

Costruttori

TextRange(TextPointer, TextPointer)

Inizializza un'istanza nuova della classe TextRange, considerando due posizioni TextPointer specificate come posizioni di inizio e di fine per il nuovo intervallo.

Proprietà

End	Ottiene la posizione che contrassegna l'estremità della selezione corrente.
IsEmpty	Ottiene un valore che indica se la selezione corrente è vuota o meno.
Start	Ottiene la posizione che contrassegna l'inizio della selezione corrente.
Text	Ottiene o imposta il contenuto del testo normale della selezione corrente.

Metodi

ApplyPropertyValue(DependencyProperty, Object)	Applica una proprietà di formattazione specificata e un valore alla selezione corrente.
CanLoad(String)	Controlla se la selezione corrente può essere caricata con il contenuto in un formato dati specificato.
CanSave(String)	Controlla se la selezione corrente può essere salvata nel formato dati specificato.
ClearAllProperties()	Rimuove tutte le proprietà di formattazione (rappresentato dagli elementi Inline ) dalla selezione corrente.
Contains(TextPointer)	Controlla se una posizione (specificata da un oggetto TextPointer) è situata all'interno della selezione corrente.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetPropertyValue(DependencyProperty)	Restituisce il valore effettivo di una formattazione specificata nella selezione corrente.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Load(Stream, String)	Carica la selezione corrente in un formato dati specificato da un flusso specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Save(Stream, String)	Salva la selezione corrente in un flusso specificato in un formato dati specificato.
Save(Stream, String, Boolean)	Salva la selezione corrente in un flusso specificato in un formato dati specificato, con l’opzione per conservare gli oggetti TextElement personalizzati.
Select(TextPointer, TextPointer)	Aggiorna la selezione corrente, usando due posizioni TextPointer per indicare la selezione aggiornata.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

Changed

Si verifica quando l'intervallo viene riposizionato in riferimento a una nuova sezione di contenuto.

Vedi anche

• TextPointerContext