TextRange Classe

Definizione

Rappresenta una selezione di contenuto tra due posizioni dell'oggetto TextPointer.Represents a selection of content between two TextPointer positions.

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

Esempi

Nell'esempio seguente viene illustrato l'utilizzo della proprietà Text di un TextRange per restituire la rappresentazione in testo normale di un FlowDocumentspecificato.The following example demonstrates using the Text property of a TextRange to return the plain text representation of a specified 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 classe TextRange introduce la terminologia seguente.The TextRange class introduces the following terminology.

  • Selezione : un TextRange è una selezione del contenuto tra due posizioni indicate dai TextPointer.Selection - A TextRange is a selection of content between two positions indicated by TextPointers. Uno di questi posiziona un ancoraggio fisso rispetto alla selezione, mentre l'altra posizione è movibile.One of these positions a fixed anchor with respect to the selection, while the other position is movable. Questo comportamento è simile a quello di una selezione eseguita da un utente che usa il mouse o la tastiera.This is similar to how a selection made by a user using the mouse or keyboard behaves.

  • Selezione corrente : poiché un TextRange indica sempre una selezione nel contenuto, è opportuno fare semplicemente riferimento alla selezione indicata da un TextRange come selezione corrente.Current Selection - Because a TextRange always indicates a selection in content, it makes sense to simply refer to the selection indicated by a TextRange as the current selection.

  • Contenitore di testo : un contenitore di testo è l'elemento che costituisce il bordo finale per il contenuto del flusso a mano; la selezione indicata da un TextRange rientra sempre all'interno di un contenitore di testo.Text Container - A text container is the element that forms the ultimate border for the flow content at hand; the selection indicated by a TextRange always falls within a text container. Attualmente, è necessario che un contenitore di testo sia un FlowDocument o una TextBlock.Currently, a text container must be either a FlowDocument or a TextBlock.

  • Documento : il contenuto collettivamente contenuto all'interno di un contenitore di testo viene definito documento.Document - The content collectively contained within a text container is referred to as a document.

Per ulteriori informazioni su altri termini come position, vedere TextPointer.For more information about other related terms like position, see 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.Initializes a new instance of the TextRange class, taking two specified TextPointer positions as the beginning and end positions for the new range.

Proprietà

End

Ottiene la posizione che contrassegna l'estremità della selezione corrente.Get the position that marks the end of the current selection.

IsEmpty

Ottiene un valore che indica se la selezione corrente è vuota o meno.Gets a value indicating whether or not the current selection is empty.

Start

Ottiene la posizione che contrassegna l'inizio della selezione corrente.Gets the position that marks the beginning of the current selection.

Text

Ottiene o imposta il contenuto del testo normale della selezione corrente.Gets or sets the plain text contents of the current selection.

Metodi

ApplyPropertyValue(DependencyProperty, Object)

Applica una proprietà di formattazione specificata e un valore alla selezione corrente.Applies a specified formatting property and value to the current selection.

CanLoad(String)

Controlla se la selezione corrente può essere caricata con il contenuto in un formato dati specificato.Checks whether the current selection can be loaded with content in a specified data format.

CanSave(String)

Controlla se la selezione corrente può essere salvata nel formato dati specificato.Checks whether the current selection can be saved as a specified data format.

ClearAllProperties()

Rimuove tutte le proprietà di formattazione (rappresentato dagli elementi Inline ) dalla selezione corrente.Removes all formatting properties (represented by Inline elements) from the current selection.

Contains(TextPointer)

Controlla se una posizione (specificata da un oggetto TextPointer) è situata all'interno della selezione corrente.Checks whether a position (specified by a TextPointer) is located within the current selection.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetPropertyValue(DependencyProperty)

Restituisce il valore effettivo di una formattazione specificata nella selezione corrente.Returns the effective value of a specified formatting property on the current selection.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
Load(Stream, String)

Carica la selezione corrente in un formato dati specificato da un flusso specificato.Loads the current selection in a specified data format from a specified stream.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
Save(Stream, String)

Salva la selezione corrente in un flusso specificato in un formato dati specificato.Saves the current selection to a specified stream in a specified data format.

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.Saves the current selection to a specified stream in a specified data format, with the option of preserving custom TextElement objects.

Select(TextPointer, TextPointer)

Aggiorna la selezione corrente, usando due posizioni TextPointer per indicare la selezione aggiornata.Updates the current selection, taking two TextPointer positions to indicate the updated selection.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Eventi

Changed

Si verifica quando l'intervallo viene riposizionato in riferimento a una nuova sezione di contenuto.Occurs when the range is repositioned to cover a new span of content.

Si applica a

Vedi anche