Condividi tramite

TextRange Classe

Definizione

Spazio dei nomi:
System.Windows.Documents
Assembly:
PresentationFramework.dll

Rappresenta una selezione di contenuto tra due TextPointer posizioni.

public ref class TextRange
public class TextRange
type TextRange = class
Public Class TextRange
Ereditarietà
Object
TextRange
Derivato

Esempio

Nell'esempio seguente viene illustrato l'utilizzo della Text proprietà di un TextRange oggetto per restituire la rappresentazione in testo normale di un oggetto specificato 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

Commenti

La TextRange classe introduce la terminologia seguente.

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

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

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

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

Per altre informazioni su altri termini correlati, ad esempio la posizione, vedere TextPointer.

Costruttori

Nome Descrizione
TextRange(TextPointer, TextPointer)

Inizializza una nuova istanza della TextRange classe , accettando due posizioni specificate TextPointer come posizioni iniziale e finale per il nuovo intervallo.

Proprietà

Nome Descrizione
End

Ottiene la posizione che contrassegna la fine della selezione corrente.
IsEmpty

Ottiene un valore che indica se la selezione corrente è vuota.
Start

Ottiene la posizione che contrassegna l'inizio della selezione corrente.
Text

Ottiene o imposta il contenuto di testo normale della selezione corrente.

Metodi

Nome Descrizione
ApplyPropertyValue(DependencyProperty, Object)

Applica una proprietà di formattazione e un valore specificati alla selezione corrente.
CanLoad(String)

Verifica se la selezione corrente può essere caricata con contenuto in un formato di dati specificato.
CanSave(String)

Controlla se la selezione corrente può essere salvata come formato di dati specificato.
ClearAllProperties()

Rimuove tutte le proprietà di formattazione (rappresentate dagli Inline elementi) dalla selezione corrente.
Contains(TextPointer)

Controlla se una posizione (specificata da un TextPointer) si trova 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 proprietà di formattazione specificata nella selezione corrente.
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
Load(Stream, String)

Carica la selezione corrente in un formato di dati specificato da un flusso specificato.
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
Save(Stream, String, Boolean)

Salva la selezione corrente in un flusso specificato in un formato di dati specificato, con l'opzione di mantenimento di oggetti personalizzati TextElement .
Save(Stream, String)

Salva la selezione corrente in un flusso specificato in un formato di dati specificato.
Select(TextPointer, TextPointer)

Aggiorna la selezione corrente, prendendo due TextPointer posizioni per indicare la selezione aggiornata.
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Eventi

Nome Descrizione
Changed

Si verifica quando l'intervallo viene riposizionato per coprire un nuovo intervallo di contenuto.

Si applica a

Vedi anche