TextChangedEventArgs.Changes Properti

Definisi

Ruang nama:

System.Windows.Controls

Rakitan:

PresentationFramework.dll

Mendapatkan kumpulan objek yang berisi informasi tentang perubahan yang terjadi.

public:
 property System::Collections::Generic::ICollection<System::Windows::Controls::TextChange ^> ^ Changes { System::Collections::Generic::ICollection<System::Windows::Controls::TextChange ^> ^ get(); };

public System.Collections.Generic.ICollection<System.Windows.Controls.TextChange> Changes { get; }

member this.Changes : System.Collections.Generic.ICollection<System.Windows.Controls.TextChange>

Public ReadOnly Property Changes As ICollection(Of TextChange)

Nilai Properti

ICollection<TextChange>

Kumpulan objek yang berisi informasi tentang perubahan yang terjadi.

Keterangan

Ada satu TextChange objek untuk setiap perubahan berturut-turut pada kontrol. Lebih dari satu perubahan berturut-turut dapat terjadi selama satu kejadian TextChanged peristiwa ketika perubahan memerlukan perubahan struktur dokumen yang mendasar.

Misalnya, misalkan berisi RichTextBox string "This is some text." Struktur RichTextBox.Document adalah <Paragraph><Run>This is some text.</Run></Paragraph>. Jika pengguna menebalkan kata -kata "is some", struktur perubahan yang mendasar FlowDocument menjadi <Paragraph><Run>This </Run><Run FontWeight="Bold">is some</Run><Run> text.</Run></Paragraph>. Sebenarnya ada empat perubahan yang terjadi sebagai akibat dari tindakan pengguna:

1. Simbol <Run> dihapus dan ditambahkan kembali sebelum kata This.

2. Simbol </Run><Run> ditambahkan setelah kata This.

3. Simbol </Run><Run> ditambahkan setelah kata some.

4. Simbol </Run> dihapus dan ditambahkan kembali setelah kata Text.

Secara umum, berikut ini akan selalu benar:

• Perubahan yang terjadi mengakibatkan dokumen berada dalam status valid.

• Koleksi diurutkan secara berturut-turut, terkait dengan di mana perubahan terjadi dalam kontrol. Misalnya, TextChange objek yang mewakili perubahan pada posisi 2 adalah sebelum TextChange objek yang mewakili perubahan pada posisi 10.

• Dua TextChange objek tidak mewakili area yang tumpang tindih. Nilai Offset plus nilai dari AddedLength satu TextChange objek selalu kurang dari atau sama dengan nilai Offset objek berikutnya TextChange dalam koleksi. Demikian juga, nilai Offset plus nilai satu TextChangeRemovedLength objek selalu kurang dari atau sama dengan nilai Offset objek berikutnya TextChange dalam koleksi.

• Koleksi ini mencerminkan perubahan apa pun yang terjadi, bahkan jika tampaknya tidak ada perubahan bersih. Dalam contoh sebelumnya, perubahan pertama atau keempat tidak menghasilkan perubahan bersih, karena masing-masing hanya dihapus dan ditambahkan <Run> kembali simbol dan </Run> . Tetapi simbol-simbol itu benar-benar dihapus dan ditambahkan, sehingga termasuk dalam koleksi.

TextChanged Jika peristiwa terjadi sebagai akibat dari perubahan properti, Changes adalah koleksi kosong. Dalam contoh sebelumnya, jika pengguna menebalkan seluruh string, FontWeight properti diatur Run ke Bold, tetapi tidak ada yang ditambahkan atau dihapus dari dokumen, jadi Changes kosong.

Changesdiperkenalkan dalam .NET Framework versi 3.5. Untuk informasi selengkapnya, lihat Versi dan Dependensi.