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

Примеры

В следующем примере показано использование Text свойства a TextRange для возврата представления обычного текста указанного объекта 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 всегда находится в текстовом контейнере. В настоящее время текстовый контейнер должен быть либо a 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)	Сохраняет текущее выделение в указанном формате данных из указанного потока.
Save(Stream, String, Boolean)	Сохраняет текущее выделение в указанный поток в указанном формате данных с возможностью сохранения пользовательских объектов TextElement.
Select(TextPointer, TextPointer)	Обновляет текущее выделение, принимая две позиции TextPointer для указания обновленного выделения.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

Changed

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

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

• TextPointerContext