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 Text propiedad de para TextRange devolver la representación de texto sin formato de un especificado 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

Comentarios

La TextRange clase presenta la siguiente terminología.

• Selección : TextRange una es una selección de contenido entre dos posiciones indicadas por TextPointers. Una de estas posiciones es un anclaje fijo con respecto a la selección, mientras que la otra posición es móvil. 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 como TextRange la selección actual.

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

• Documento : 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 position, vea TextPointer.

Constructores

TextRange(TextPointer, TextPointer)

Inicializa una nueva instancia de la clase TextRange, que toma dos posiciones TextPointer especificadas como las posiciones inicial y final para el nuevo intervalo.

Propiedades

End	Obtiene la posición que marca el final de la selección actual.
IsEmpty	Obtiene un valor que indica si la selección actual es vacía o no.
Start	Obtiene la posición que marca el principio de la selección actual.
Text	Obtiene o establece el contenido del 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 se puede cargar la selección actual con contenido en un formato de datos especificado.
CanSave(String)	Comprueba si se puede guardar la selección actual como formato de datos especificado.
ClearAllProperties()	Quita todas las propiedades de formato (representadas por elementos Inline) de la selección actual.
Contains(TextPointer)	Comprueba si una posición (especificada por TextPointer) se encuentra dentro de la selección actual.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetPropertyValue(DependencyProperty)	Devuelve el valor vigente 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 Object actual. (Heredado de Object)
Save(Stream, String)	Guarda la selección actual en una secuencia especificada en un formato de datos especificado.
Save(Stream, String, Boolean)	Guarda la selección actual en una secuencia indicada con un formato de datos especificado, con la opción de conservar los objetos TextElement personalizados.
Select(TextPointer, TextPointer)	Actualiza la selección actual y toma 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 vuelve a ubicar el rango para cubrir un intervalo nuevo de contenido.

Consulte también

• TextPointerContext