TextRange Класс

Определение

Представляет выделение содержимого между двумя позициями TextPointer.Represents a selection of content between two TextPointer positions.

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

Примеры

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

Комментарии

TextRange Класс вводит следующую терминологию.The TextRange class introduces the following terminology.

  • Selection (выбор TextRange ) — это выбор содержимого между двумя позициями, обозначенными с помощью параметра TextPoint.Selection - A TextRange is a selection of content between two positions indicated by TextPointers. В одной из них фиксированная привязка задается по отношению к выделенной области, а другая позиция является перемещаемой.One of these positions a fixed anchor with respect to the selection, while the other position is movable. Это похоже на то, как работает выделение, выполняемое пользователем или клавиатурой с помощью мыши или клавиатуры.This is similar to how a selection made by a user using the mouse or keyboard behaves.

  • Текущее выделение . Поскольку всегда TextRange указывает на выбор в содержимом, имеет смысл просто ссылаться на выделение, указанное в TextRange качестве текущего выделения.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.

  • Контейнер текстатекстовый контейнер — это элемент, который формирует конечную границу для содержимого нефиксированного формата. выбор, обозначенный TextRange , всегда попадает в текстовый контейнер.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. В настоящее время контейнер текста должен быть FlowDocument либо TextBlockили.Currently, a text container must be either a FlowDocument or a TextBlock.

  • Document — содержимое, которое совместно содержится в текстовом контейнере, называется документом.Document - The content collectively contained within a text container is referred to as a document.

Дополнительные сведения о других связанных терминах, ** таких как « TextPointerпозиционирование», см. в разделе.For more information about other related terms like position, see TextPointer.

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

TextRange(TextPointer, TextPointer)

Инициализирует новый экземпляр класса TextRange, принимая две указанных позиции TextPointer в качестве начальной и конечной позиций для нового интервала.Initializes a new instance of the TextRange class, taking two specified TextPointer positions as the beginning and end positions for the new range.

Свойства

End

Получает позицию, помечающую край текущего выделения.Get the position that marks the end of the current selection.

IsEmpty

Получает значение, указывающее, является ли текущее выделение пустым или нет.Gets a value indicating whether or not the current selection is empty.

Start

Получает позицию, помечающую начало текущего выделения.Gets the position that marks the beginning of the current selection.

Text

Получает или задает текстовое содержимое текущего выделения.Gets or sets the plain text contents of the current selection.

Методы

ApplyPropertyValue(DependencyProperty, Object)

Применяет указанное свойство форматирования и значение к текущему выделению.Applies a specified formatting property and value to the current selection.

CanLoad(String)

Проверяет возможность загрузки текущего выделения содержимым в указанном формате данных.Checks whether the current selection can be loaded with content in a specified data format.

CanSave(String)

Проверяет возможность сохранения текущего выделения в указанном формате данных.Checks whether the current selection can be saved as a specified data format.

ClearAllProperties()

Удаляет все свойства форматирования (представленные элементами Inline) из текущего выделения.Removes all formatting properties (represented by Inline elements) from the current selection.

Contains(TextPointer)

Проверяет расположена ли позиция (указанная TextPointer) в текущем выделении.Checks whether a position (specified by a TextPointer) is located within the current selection.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetPropertyValue(DependencyProperty)

Возвращает эффективное значение указанного свойства форматирования в текущем выделении.Returns the effective value of a specified formatting property on the current selection.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
Load(Stream, String)

Загружает текущее выделение в указанном формате данных из указанного потока.Loads the current selection in a specified data format from a specified stream.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
Save(Stream, String)

Сохраняет текущее выделение в указанном формате данных из указанного потока.Saves the current selection to a specified stream in a specified data format.

Save(Stream, String, Boolean)

Сохраняет текущее выделение в указанный поток в указанном формате данных с возможностью сохранения пользовательских объектов TextElement.Saves the current selection to a specified stream in a specified data format, with the option of preserving custom TextElement objects.

Select(TextPointer, TextPointer)

Обновляет текущее выделение, принимая две позиции TextPointer для указания обновленного выделения.Updates the current selection, taking two TextPointer positions to indicate the updated selection.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

События

Changed

Происходит при изменении положения диапазона для покрытия нового фрагмента содержимого.Occurs when the range is repositioned to cover a new span of content.

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

Дополнительно