TextChangedEventArgs.Changes Eigenschaft

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ruft eine Auflistung von Objekten ab, die Informationen zu den aufgetretenen Änderungen enthält.

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)

Eigenschaftswert

ICollection<TextChange>

Eine Auflistung von Objekten, die Informationen zu den aufgetretenen Änderungen enthält.

Hinweise

Es gibt ein TextChange Objekt für jede aufeinander folgende Änderung des Steuerelements. Mehrere aufeinander folgende Änderungen können während eines Auftretens des TextChanged Ereignisses auftreten, wenn die Änderung die Struktur des zugrunde liegenden Dokuments ändert.

Angenommen, eine RichTextBox enthält die Zeichenfolge Die Struktur der RichTextBox.Document Zeichenfolge "This is some text." ist <Paragraph><Run>This is some text.</Run></Paragraph>. Wenn der Benutzer die Wörter "is some"fett formatiert, ändert sich die Struktur der zugrunde liegenden FlowDocument Änderungen in <Paragraph><Run>This </Run><Run FontWeight="Bold">is some</Run><Run> text.</Run></Paragraph>. Es gibt tatsächlich vier Änderungen, die aufgrund der Aktion des Benutzers vorgenommen wurden:

1. Das <Run> Symbol wird entfernt und vor dem Wort Thiserneut hinzugefügt.

2. Die Symbole </Run><Run> werden nach dem Wort Thishinzugefügt.

3. Die Symbole </Run><Run> werden nach dem Wort somehinzugefügt.

4. Das </Run> Symbol wird entfernt und nach dem Wort Texterneut hinzugefügt.

Im Allgemeinen gilt Folgendes immer:

• Die änderungen, die auftreten, führen dazu, dass das Dokument in einem gültigen Zustand ist.

• Die Auflistung wird fortlaufend sortiert, soweit die Änderung im Steuerelement aufgetreten ist. Beispielsweise befindet sich ein TextChange Objekt, das eine Änderung an Position 2 darstellt, vor einem TextChange Objekt, das eine Änderung an Position 10 darstellt.

• Zwei TextChange Objekte stellen keinen überlappenden Bereich dar. Der Wert plus Offset des Werts eines AddedLengthTextChange Objekts ist immer kleiner oder gleich dem Wert des Offset nächsten TextChange Objekts in der Auflistung. Ebenso ist der Wert plus Offset des Werts eines TextChangeRemovedLength Objekts immer kleiner oder gleich dem Wert des Offset nächsten TextChange Objekts in der Auflistung.

• Die Sammlung spiegelt alle änderungen wider, auch wenn es scheinbar keine Nettoänderung gibt. Im vorangehenden Beispiel führt weder die erste noch die vierte Änderung zu einer Nettoänderung, da jede einfach entfernte bzw. neu hinzugefügte Symbole entfernt bzw</Run>. neu hinzugefügt <Run> hat. Die Symbole wurden jedoch tatsächlich entfernt und hinzugefügt, sodass sie in der Sammlung enthalten sind.

Wenn das TextChanged Ereignis als Ergebnis einer Eigenschaftsänderung auftritt, Changes handelt es sich um eine leere Auflistung. Wenn der Benutzer im vorangehenden Beispiel die gesamte Zeichenfolge fett formatiert, wird die FontWeight Eigenschaft der Run Zeichenfolge auf festgelegt Bold, aber es wird nichts hinzugefügt oder aus dem Dokument entfernt. Dies ist also Changes leer.

Changes wird in .NET Framework, Version 3.5, eingeführt. Weitere Informationen finden Sie unter "Versionen und Abhängigkeiten".