TextRange Classe

Definição

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Representa uma seleção de conteúdo entre duas posições TextPointer.

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

Herança

Object

TextRange

Derivado

System.Windows.Documents.TextSelection

Exemplos

O exemplo a seguir demonstra o Text uso da propriedade de um TextRange para retornar a representação de texto sem formatação de um 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

Comentários

A TextRange classe apresenta a terminologia a seguir.

• Seleção – A TextRange é uma seleção de conteúdo entre duas posições indicadas por TextPointers. Uma dessas posições é uma âncora fixa em relação à seleção, enquanto a outra posição é móvel. Isso é semelhante a como uma seleção feita por um usuário que usa o mouse ou teclado se comporta.

• Seleção Atual – como uma TextRange seleção sempre indica uma seleção no conteúdo, faz sentido simplesmente fazer referência à seleção indicada por um TextRange como a seleção atual.

• Contêiner de Texto – Um contêiner de texto é o elemento que forma a borda final para o conteúdo de fluxo em questão; a seleção indicada por um TextRange sempre se enquadra em um contêiner de texto. Atualmente, um contêiner de texto deve ser um FlowDocument ou um TextBlock.

• Documento – O conteúdo contido coletivamente em um contêiner de texto é chamado de documento.

Para obter mais informações sobre outros termos relacionados, como posição, consulte TextPointer.

Construtores

TextRange(TextPointer, TextPointer)

Inicializa uma nova instância da classe TextRange, assumindo duas posições TextPointer especificadas como as posições inicial e final do novo intervalo.

Propriedades

End	Obtenha a posição que marca o fim da seleção atual.
IsEmpty	Obtém um valor que indica se a seleção atual está vazia ou não.
Start	Obtém a posição que marca o início da seleção atual.
Text	Obtém ou define o conteúdo de texto sem formatação da seleção atual.

Métodos

ApplyPropertyValue(DependencyProperty, Object)	Aplica uma propriedade de formatação e o respectivo valor especificados à seleção atual.
CanLoad(String)	Verifica se a seleção atual pode ser carregada com o conteúdo em um formato de dados especificado.
CanSave(String)	Verifica se a seleção atual pode ser salva como um formato de dados especificado.
ClearAllProperties()	Remove todas as propriedades de formatação (representadas por elementos Inline) na seleção atual.
Contains(TextPointer)	Verifica se uma posição (especificada por um TextPointer) está localizada na seleção atual.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetPropertyValue(DependencyProperty)	Retorna o valor efetivo de uma propriedade de formatação especificada na seleção atual.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Load(Stream, String)	Carrega a seleção atual em um determinado formato de dados de um fluxo especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Save(Stream, String)	Salva a seleção atual em um determinado fluxo de um formato de dados especificado.
Save(Stream, String, Boolean)	Salva a seleção atual em um fluxo especificado em um formato de dados especificado, com a opção de preservar objetos TextElement personalizados.
Select(TextPointer, TextPointer)	Atualiza a seleção atual, levando duas posições TextPointer para indicar a seleção atualizada.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Eventos

Changed

Ocorre quando o intervalo é reposicionado de forma a cobrir uma nova faixa de conteúdo.

Confira também

• TextPointerContext