TextRange(TextPointer, TextPointer) Конструктор

Определение

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

System.Windows.Documents

Сборка:

PresentationFramework.dll

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

public:
 TextRange(System::Windows::Documents::TextPointer ^ position1, System::Windows::Documents::TextPointer ^ position2);

public TextRange (System.Windows.Documents.TextPointer position1, System.Windows.Documents.TextPointer position2);

new System.Windows.Documents.TextRange : System.Windows.Documents.TextPointer * System.Windows.Documents.TextPointer -> System.Windows.Documents.TextRange

Public Sub New (position1 As TextPointer, position2 As TextPointer)

Параметры

position1

TextPointer

Фиксированная привязанная позиция, помечающая один край выделения, используемый для формирования нового TextRange.

position2

TextPointer

Перемещаемая позиция, помечающая другой край выделения, используемый для формирования нового TextRange.

Исключения

ArgumentException

Происходит, когда position1 и position2 не находятся в пределах одного документа.

ArgumentNullException

Происходит, когда position1 или position2 имеет значение null.

Примеры

В следующем примере показано использование конструктора TextRange .

// 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

Комментарии

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

Фактические концы нового TextRange могут быть скорректированы в соответствии с любыми эвристиками выбора, применимыми к документу, содержаму новый TextRange.