TextRange TextRange TextRange TextRange Class

Definición

Representa una selección de contenido entre dos posiciones TextPointer.Represents a selection of content between two TextPointer positions.

public ref class TextRange
public class TextRange
type TextRange = class
Public Class TextRange
Herencia
TextRangeTextRangeTextRangeTextRange
Derivado

Ejemplos

El ejemplo siguiente se muestra cómo utilizar el Text propiedad de un TextRange para devolver la representación de texto sin formato de un FlowDocument.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

Comentarios

La TextRange clase presenta la terminología siguiente.The TextRange class introduces the following terminology.

  • Selección - A TextRange es una selección de contenido entre dos posiciones indicadas por TextPointers.Selection - A TextRange is a selection of content between two positions indicated by TextPointers. Uno de estos coloca un delimitador fijo con respecto a la selección, mientras que la otra posición es móvil.One of these positions a fixed anchor with respect to the selection, while the other position is movable. Esto es similar a cómo se comporta una selección realizada por un usuario con el mouse o teclado.This is similar to how a selection made by a user using the mouse or keyboard behaves.

  • Selección actual : porque un TextRange siempre indica una selección en el contenido, tiene sentido simplemente hacer referencia a la selección indicada por un TextRange como el selección actual.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.

  • Contenedor de texto - A contenedor de texto es el elemento que constituye el borde final para el contenido dinámico en cuestión; la selección indicada por un TextRange siempre se encuentra dentro de un contenedor de texto.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. Actualmente, un contenedor de texto debe ser un FlowDocument o TextBlock.Currently, a text container must be either a FlowDocument or a TextBlock.

  • Documento -el contenido incluido de forma colectiva en un contenedor de texto se conoce como un documento.Document - The content collectively contained within a text container is referred to as a document.

Para obtener más información acerca de otros relacionados con los términos posición, consulte TextPointer.For more information about other related terms like position, see TextPointer.

Constructores

TextRange(TextPointer, TextPointer) TextRange(TextPointer, TextPointer) TextRange(TextPointer, TextPointer) 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.Initializes a new instance of the TextRange class, taking two specified TextPointer positions as the beginning and end positions for the new range.

Propiedades

End End End End

Obtiene la posición que marca el final de la selección actual.Get the position that marks the end of the current selection.

IsEmpty IsEmpty IsEmpty IsEmpty

Obtiene un valor que indica si la selección actual es vacía o no.Gets a value indicating whether or not the current selection is empty.

Start Start Start Start

Obtiene la posición que marca el principio de la selección actual.Gets the position that marks the beginning of the current selection.

Text Text Text Text

Obtiene o establece el contenido del texto sin formato de la selección actual.Gets or sets the plain text contents of the current selection.

Métodos

ApplyPropertyValue(DependencyProperty, Object) ApplyPropertyValue(DependencyProperty, Object) ApplyPropertyValue(DependencyProperty, Object) ApplyPropertyValue(DependencyProperty, Object)

Aplica una propiedad de formato y un valor especificados a la selección actual.Applies a specified formatting property and value to the current selection.

CanLoad(String) CanLoad(String) CanLoad(String) CanLoad(String)

Comprueba si se puede cargar la selección actual con contenido en un formato de datos especificado.Checks whether the current selection can be loaded with content in a specified data format.

CanSave(String) CanSave(String) CanSave(String) CanSave(String)

Comprueba si se puede guardar la selección actual como formato de datos especificado.Checks whether the current selection can be saved as a specified data format.

ClearAllProperties() ClearAllProperties() ClearAllProperties() ClearAllProperties()

Quita todas las propiedades de formato (representadas por elementos Inline) de la selección actual.Removes all formatting properties (represented by Inline elements) from the current selection.

Contains(TextPointer) Contains(TextPointer) Contains(TextPointer) Contains(TextPointer)

Comprueba si una posición (especificada por TextPointer) se encuentra dentro de la selección actual.Checks whether a position (specified by a TextPointer) is located within the current selection.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetPropertyValue(DependencyProperty) GetPropertyValue(DependencyProperty) GetPropertyValue(DependencyProperty) GetPropertyValue(DependencyProperty)

Devuelve el valor vigente de una propiedad de formato especificada en la selección actual.Returns the effective value of a specified formatting property on the current selection.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
Load(Stream, String) Load(Stream, String) Load(Stream, String) Load(Stream, String)

Carga la selección actual en un formato de datos especificado de una secuencia especificada.Loads the current selection in a specified data format from a specified stream.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
Save(Stream, String) Save(Stream, String) Save(Stream, String) Save(Stream, String)

Guarda la selección actual en una secuencia especificada en un formato de datos especificado.Saves the current selection to a specified stream in a specified data format.

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

Select(TextPointer, TextPointer) Select(TextPointer, TextPointer) Select(TextPointer, TextPointer) Select(TextPointer, TextPointer)

Actualiza la selección actual, tomando dos posiciones TextPointer para indicar la selección actualizada.Updates the current selection, taking two TextPointer positions to indicate the updated selection.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Eventos

Changed Changed Changed Changed

Se produce cuando se vuelve a ubicar el rango para cubrir un intervalo nuevo de contenido.Occurs when the range is repositioned to cover a new span of content.

Se aplica a

Consulte también: