TextRange Класс

Определение

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

public ref class TextRange
public class TextRange
type TextRange = class
Public Class TextRange
Наследование
TextRange
Производный

Примеры

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

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

Применяется к

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