TextRange Класс

Определение

Пространство имен:

System.Windows.Documents

Сборка:

PresentationFramework.dll

Представляет выбор содержимого между двумя TextPointer позициями.

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

Наследование

Object

TextRange

Производный

System.Windows.Documents.TextSelection

Примеры

В следующем примере показано использование свойства TextTextRange для возврата представления обычного текста указанного 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

Комментарии

Класс TextRange вводит следующую терминологию.

• выделения . TextRange — это выбор содержимого между двумя позициями, указанными TextPointers. Одна из этих позиций фиксированная привязка относительно выбора, а другая позиция перемещается. Это похоже на то, как выполняется выбор, сделанный пользователем с помощью мыши или клавиатуры.

• Текущее выделение . Так как TextRange всегда указывает на выделение в содержимом, то имеет смысл просто ссылаться на выбор, указанный TextRange, как текущийвыбора.

• текстовый контейнер — текстовый контейнер является элементом, который формирует конечную границу для содержимого потока; выделение, указанное TextRange всегда находится в текстовом контейнере. В настоящее время текстовый контейнер должен быть FlowDocument или TextBlock.

• документ . Содержимое, содержащееся в текстовом контейнере, называется документом.

Дополнительные сведения о других связанных терминах, таких как позиции, см. в TextPointer.

Конструкторы

TextRange(TextPointer, TextPointer)

Инициализирует новый экземпляр класса TextRange, принимая две указанные TextPointer позиции в качестве начальной и конечной позиций для нового диапазона.

Свойства

End	Получите позицию, которая помечает конец текущего выбора.
IsEmpty	Возвращает значение, указывающее, является ли текущий выбор пустым.
Start	Возвращает позицию, обозначающую начало текущего выделения.
Text	Возвращает или задает содержимое обычного текста текущего выделенного фрагмента.

Методы

ApplyPropertyValue(DependencyProperty, Object)	Применяет указанное свойство форматирования и значение к текущему выбору.
CanLoad(String)	Проверяет, можно ли загрузить текущий выбор с содержимым в указанном формате данных.
CanSave(String)	Проверяет, можно ли сохранить текущий выбор в виде указанного формата данных.
ClearAllProperties()	Удаляет все свойства форматирования (представленные элементами Inline) из текущего выбора.
Contains(TextPointer)	Проверяет, находится ли позиция (указанная TextPointer) в текущем выборе.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetPropertyValue(DependencyProperty)	Возвращает эффективное значение указанного свойства форматирования в текущем выборе.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
Load(Stream, String)	Загружает текущий выбор в указанном формате данных из указанного потока.
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
Save(Stream, String, Boolean)	Сохраняет текущий выбор в указанном потоке в указанном формате данных с возможностью сохранения пользовательских TextElement объектов.
Save(Stream, String)	Сохраняет текущий выбор в указанном потоке в указанном формате данных.
Select(TextPointer, TextPointer)	Обновляет текущий выбор, принимая две позиции TextPointer, чтобы указать обновленный выбор.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

Changed

Происходит при перепозиции диапазона для покрытия нового диапазона содержимого.

См. также раздел

• TextPointerContext