Classe TextRange (System.Windows.Documents)

Cambia visualizzazione:
Classica
Lightweight
ScriptFree
Riferimento a .NET Framework
Classe TextRange
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

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

Gerarchia di ereditarietà
System.Object
  System.Windows.Documents.TextRange
    System.Windows.Documents.TextSelection

Spazio dei nomi:  System.Windows.Documents
Assembly:  PresentationFramework (in PresentationFramework.dll)
Sintassi
Visual Basic
Public Class TextRange
C#
public class TextRange
Visual C++
public ref class TextRange
F#
type TextRange =  class end

Il tipo TextRange espone i seguenti membri.

Costruttori
  Nome Descrizione
Metodo pubblico TextRange Inizializza un'istanza nuova della classe TextRange, considerando due posizioni TextPointer specificate come posizioni di inizio e di fine per il nuovo intervallo.
In alto
Proprietà
  Nome Descrizione
Proprietà pubblica End Ottiene la posizione che contrassegna l'estremità della selezione corrente.
Proprietà pubblica IsEmpty Ottiene un valore che indica se la selezione corrente è vuota o meno.
Proprietà pubblica Start Ottiene la posizione che contrassegna l'inizio della selezione corrente.
Proprietà pubblica Text Ottiene o imposta il contenuto del testo normale della selezione corrente.
In alto
Metodi
  Nome Descrizione
Metodo pubblico ApplyPropertyValue Applica una proprietà di formattazione specificata e un valore alla selezione corrente.
Metodo pubblico CanLoad Controlla se la selezione corrente può essere caricata con il contenuto in un formato dati specificato.
Metodo pubblico CanSave Controlla se la selezione corrente può essere salvata nel formato dati specificato.
Metodo pubblico ClearAllProperties Rimuove tutte le proprietà di formattazione (rappresentato dagli elementi Inline ) dalla selezione corrente.
Metodo pubblico Contains Controlla se una posizione (specificata da un oggetto TextPointer) è situata all'interno della selezione corrente.
Metodo pubblico Equals(Object) Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object)
Metodo protetto Finalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblico GetHashCode Funge da funzione hash per un determinato tipo. (Ereditato da Object)
Metodo pubblico GetPropertyValue Restituisce il valore effettivo di una formattazione specificata nella selezione corrente.
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblico Load Carica la selezione corrente in un formato dati specificato da un flusso specificato.
Metodo protetto MemberwiseClone Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo pubblico Save(Stream, String) Salva la selezione corrente in un flusso specificato in un formato dati specificato.
Metodo pubblico 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.
Metodo pubblico Select Aggiorna la selezione corrente, prendendo due posizioni dell'oggetto TextPointer per indicare la selezione aggiornata.
Metodo pubblico ToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
In alto
Eventi
  Nome Descrizione
Evento pubblico Changed Si verifica quando l'intervallo viene riposizionato per analizzare un'estensione nuova di contenuto.
In alto
Note

La classe TextRange introduce la terminologia seguente.

  • Selezione - Un oggetto 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. È simile al comportamento di una selezione eseguita da un utente utilizzando il mouse o la tastiera.

  • Selezione corrente - Poiché un TextRange indica sempre una selezione nel contenuto, è opportuno fare riferimento alla selezione indicata da un TextRange come selezione corrente.

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

  • Documento - Il contenuto incluso complessivamente in un contenitore di testo viene definito documento.

Per le ulteriori informazioni su altri termini correlati come ad esempio posizione, vedere TextPointer.

Esempi

Nell'esempio seguente viene dimostrato l'utilizzo della proprietà Text di un oggetto TextRange per restituire la rappresentazione di testo normale di un oggetto FlowDocument specificato.

Visual Basic

' 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
C#

// 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;
}
Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1
Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Codice thread safe
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Vedere anche

Riferimenti

Spazio dei nomi System.Windows.Documents
TextPointerContext