TextChangedEventArgs.Changes Özellik

Tanım

Ad Alanı:

System.Windows.Controls

Bütünleştirilmiş Kod:

PresentationFramework.dll

Oluşan değişiklikler hakkında bilgi içeren bir nesne koleksiyonu alır.

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)

Özellik Değeri

ICollection<TextChange>

Oluşan değişiklikler hakkında bilgi içeren bir nesne koleksiyonu.

Açıklamalar

Denetimde ardışık yapılan her değişiklik için bir TextChange nesne vardır. Değişiklik, temel alınan belgenin TextChanged yapısını değiştirmeyi gerektirdiğinde, olayın bir oluşumu sırasında birden fazla ardışık değişiklik meydana gelebilir.

Örneğin, bir RichTextBox öğesinin dizesini "This is some text." içerdiğini varsayalım.RichTextBox.Document<Paragraph><Run>This is some text.</Run></Paragraph> Kullanıcı sözcüklerini "is some"kalın yazıyla değiştirirse, temel alınan FlowDocument öğesinin yapısı olarak <Paragraph><Run>This </Run><Run FontWeight="Bold">is some</Run><Run> text.</Run></Paragraph>değişir. Aslında kullanıcının eyleminin sonucu olarak gerçekleşen dört değişiklik vardır:

1. <Run> Simgesi kaldırılır ve sözcüğünden Thisönce yeniden eklenir.

2. Simgeler </Run><Run> sözcüğünden Thissonra eklenir.

3. Simgeler </Run><Run> sözcüğünden somesonra eklenir.

4. </Run> simgesi kaldırılır ve sözcüğünden Textsonra yeniden eklenir.

Genel olarak, aşağıdakiler her zaman doğru olacaktır:

• Gerçekleşen değişiklikler belgenin geçerli bir durumda olmasına neden olur.

• Koleksiyon, değişikliğin denetimde nerede gerçekleştiğiyle ilgili olarak art arda sıralanır. Örneğin, 2 konumundaki bir değişikliği temsil eden bir TextChange nesne, 10 konumundaki bir değişikliği temsil eden bir nesneden öncedir TextChange .

• İki TextChange nesne çakışan bir alanı temsil eder. Offset Değeri artı bir TextChange nesnenin AddedLength değeri her zaman koleksiyondaki bir sonraki TextChange nesnenin Offset değerinden küçük veya buna eşittir. Benzer şekilde, Offset bir TextChange nesnenin artı değerinin RemovedLength değeri her zaman koleksiyondaki bir sonraki TextChange nesnenin Offset değerinden küçük veya buna eşit olur.

• Koleksiyon, net bir değişiklik olmadığı gibi görünse bile gerçekleşen değişiklikleri yansıtır. Yukarıdaki örnekte, ilk veya dördüncü değişiklik net bir değişiklikle sonuçlanmadığından, her biri sırasıyla ve </Run> simgelerini kaldırıp yeniden eklemektedir<Run>. Ancak semboller aslında kaldırıldı ve eklendi, bu nedenle koleksiyona dahil edildiler.

TextChanged Olay bir özellik değişikliğinin sonucu olarak gerçekleşirse, Changes boş bir koleksiyondur. Yukarıdaki örnekte, kullanıcı dizenin tamamını kalın yazarsa özelliği FontWeightRun olarak Boldayarlanır, ancak hiçbir şey eklenmez veya belgeden kaldırılmaz, bu nedenle Changes boş olur.

Changes .NET Framework sürüm 3.5'te kullanıma sunulmuştur. Daha fazla bilgi için bkz . Sürümler ve Bağımlılıklar.