TextRange Clase

Definición

Espacio de nombres:

System.Windows.Documents

Ensamblado:

PresentationFramework.dll

Representa una selección de contenido entre dos posiciones TextPointer.

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

Herencia

Object

TextRange

Derivado

System.Windows.Documents.TextSelection

Ejemplos

En el ejemplo siguiente se muestra el uso de la propiedad Text de un TextRange para devolver la representación de texto sin formato de un FlowDocumentespecificado.

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

Comentarios

La clase TextRange presenta la terminología siguiente.

• Selección: un TextRange es una selección de contenido entre dos posiciones indicadas por TextPointers. Una de estas posiciones es un delimitador fijo con respecto a la selección, mientras que la otra posición es extraíble. Esto es similar a cómo se comporta una selección realizada por un usuario mediante el mouse o el teclado.

• selección actual: dado que un TextRange siempre indica una selección en el contenido, tiene sentido simplemente hacer referencia a la selección indicada por un TextRange como selección actual.

• contenedor de texto: contenedor de texto es el elemento que forma el borde final del contenido del flujo a mano; la selección indicada por un TextRange siempre se encuentra dentro de un contenedor de texto. Actualmente, un contenedor de texto debe ser un FlowDocument o un TextBlock.

• Document: el contenido contenido contenido colectivamente dentro de un contenedor de texto se conoce como un documento .

Para obtener más información sobre otros términos relacionados, como posición, vea TextPointer.

Constructores

TextRange(TextPointer, TextPointer)

Inicializa una nueva instancia de la clase TextRange, tomando dos posiciones TextPointer especificadas como posiciones iniciales y finales para el nuevo intervalo.

Propiedades

End	Obtenga la posición que marca el final de la selección actual.
IsEmpty	Obtiene un valor que indica si la selección actual está vacía o no.
Start	Obtiene la posición que marca el principio de la selección actual.
Text	Obtiene o establece el contenido de texto sin formato de la selección actual.

Métodos

ApplyPropertyValue(DependencyProperty, Object)	Aplica una propiedad de formato y un valor especificados a la selección actual.
CanLoad(String)	Comprueba si la selección actual se puede cargar con contenido en un formato de datos especificado.
CanSave(String)	Comprueba si la selección actual se puede guardar como un formato de datos especificado.
ClearAllProperties()	Quita todas las propiedades de formato (representadas por Inline elementos) de la selección actual.
Contains(TextPointer)	Comprueba si una posición (especificada por un TextPointer) se encuentra dentro de la selección actual.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetPropertyValue(DependencyProperty)	Devuelve el valor efectivo de una propiedad de formato especificada en la selección actual.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Load(Stream, String)	Carga la selección actual en un formato de datos especificado de una secuencia especificada.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
Save(Stream, String, Boolean)	Guarda la selección actual en una secuencia especificada en un formato de datos especificado, con la opción de conservar objetos TextElement personalizados.
Save(Stream, String)	Guarda la selección actual en una secuencia especificada en un formato de datos especificado.
Select(TextPointer, TextPointer)	Actualiza la selección actual, tomando dos posiciones TextPointer para indicar la selección actualizada.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

Changed

Se produce cuando se cambia la posición del intervalo para cubrir un nuevo intervalo de contenido.

Consulte también

• TextPointerContext