TextRange Kelas

Definisi

Ruang nama:

System.Windows.Documents

Rakitan:

PresentationFramework.dll

Mewakili pilihan konten antara dua posisi TextPointer.

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

Warisan

Object

TextRange

Turunan

System.Windows.Documents.TextSelection

Contoh

Contoh berikut menunjukkan penggunaan properti Text dari TextRange untuk mengembalikan representasi teks biasa dari FlowDocumentyang ditentukan.

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

Keterangan

Kelas TextRange memperkenalkan terminologi berikut.

• Pilihan - TextRange adalah pilihan konten antara dua posisi yang ditunjukkan oleh TextPointers. Salah satu posisi ini jangkar tetap sehubungan dengan pilihan, sementara posisi lainnya dapat bergerak. Ini mirip dengan bagaimana pilihan yang dibuat oleh pengguna menggunakan mouse atau keyboard berulah.

• Pilihan Saat Ini - Karena TextRange selalu menunjukkan pilihan dalam konten, masuk akal untuk hanya merujuk ke pilihan yang ditunjukkan oleh TextRange sebagai pilihan saat ini.

• Kontainer Teks - kontainer teks adalah elemen yang membentuk batas akhir untuk konten alur yang ada; pilihan yang ditunjukkan oleh TextRange selalu berada dalam kontainer teks. Saat ini, kontainer teks harus berupa FlowDocument atau TextBlock.

• Dokumen - Konten yang secara kolektif terkandung dalam kontainer teks disebut sebagai dokumen .

Untuk informasi selengkapnya tentang istilah terkait lainnya seperti posisi , lihat TextPointer.

Konstruktor

TextRange(TextPointer, TextPointer)

Menginisialisasi instans baru kelas TextRange, mengambil dua posisi TextPointer yang ditentukan sebagai posisi awal dan akhir untuk rentang baru.

Properti

End	Dapatkan posisi yang menandai akhir pilihan saat ini.
IsEmpty	Mendapatkan nilai yang menunjukkan apakah pilihan saat ini kosong atau tidak.
Start	Mendapatkan posisi yang menandai awal pilihan saat ini.
Text	Mendapatkan atau mengatur isi teks biasa dari pilihan saat ini.

Metode

ApplyPropertyValue(DependencyProperty, Object)	Menerapkan properti pemformatan dan nilai yang ditentukan ke pilihan saat ini.
CanLoad(String)	Memeriksa apakah pilihan saat ini dapat dimuat dengan konten dalam format data tertentu.
CanSave(String)	Memeriksa apakah pilihan saat ini dapat disimpan sebagai format data tertentu.
ClearAllProperties()	Menghapus semua properti pemformatan (diwakili oleh elemen Inline) dari pilihan saat ini.
Contains(TextPointer)	Memeriksa apakah posisi (ditentukan oleh TextPointer) terletak dalam pilihan saat ini.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetPropertyValue(DependencyProperty)	Mengembalikan nilai efektif properti pemformatan yang ditentukan pada pilihan saat ini.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
Load(Stream, String)	Memuat pilihan saat ini dalam format data tertentu dari aliran tertentu.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
Save(Stream, String, Boolean)	Menyimpan pilihan saat ini ke aliran tertentu dalam format data tertentu, dengan opsi mempertahankan objek TextElement kustom.
Save(Stream, String)	Menyimpan pilihan saat ini ke aliran tertentu dalam format data tertentu.
Select(TextPointer, TextPointer)	Memperbarui pilihan saat ini, mengambil dua posisi TextPointer untuk menunjukkan pilihan yang diperbarui.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Acara

Changed

Terjadi ketika rentang diposisikan ulang untuk mencakup rentang konten baru.

Lihat juga

• TextPointerContext