TextChangedEventArgs.Changes Eigenschap

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)

Waarde van eigenschap

Een verzameling objecten met informatie over de wijzigingen die zijn opgetreden.

Opmerkingen

Er is één TextChange object voor elke opeenvolgende wijziging in het besturingselement. Er kan meer dan één opeenvolgende wijziging optreden tijdens één gebeurtenis TextChanged wanneer de wijziging de structuur van het onderliggende document wijzigt.

Stel dat een tekenreeks RichTextBox de structuur "This is some text." van de RichTextBox.Document is <Paragraph><Run>This is some text.</Run></Paragraph>. Als de gebruiker de woorden "is some"vetdrukt, verandert de structuur van de onderliggende FlowDocument wijzigingen in <Paragraph><Run>This </Run><Run FontWeight="Bold">is some</Run><Run> text.</Run></Paragraph>. Er zijn eigenlijk vier wijzigingen die plaatsvonden als gevolg van de actie van de gebruiker:

1. Het <Run> symbool wordt verwijderd en opnieuw toegevoegd voor het woord This.

2. De symbolen </Run><Run> worden toegevoegd na het woord This.

3. De symbolen </Run><Run> worden toegevoegd na het woord some.

4. Het </Run> symbool wordt verwijderd en opnieuw toegevoegd na het woord Text.

Over het algemeen geldt het volgende altijd:

• De wijzigingen die optreden, leiden ertoe dat het document een geldige status heeft.

• De verzameling wordt opeenvolgend geordend, gerelateerd aan waar de wijziging in het besturingselement is opgetreden. Een object dat bijvoorbeeld een wijziging op positie 2 vertegenwoordigt, TextChange is vóór een TextChange object dat een wijziging aangeeft op positie 10.

• Twee TextChange objecten vertegenwoordigen geen overlappend gebied. De waarde van Offset plus de waarde van AddedLength één TextChange object is altijd kleiner dan of gelijk aan de waarde van Offset het volgende TextChange object in de verzameling. Op dezelfde manier is de waarde van Offset plus de waarde van RemovedLength één TextChange object altijd kleiner dan of gelijk aan de waarde van Offset het volgende TextChange object in de verzameling.

• De verzameling weerspiegelt de wijzigingen die zijn opgetreden, zelfs als er geen nettowijziging lijkt te zijn. In het voorgaande voorbeeld resulteert de eerste of vierde wijziging niet in een nettowijziging, omdat elke wijziging eenvoudigweg is <Run></Run> verwijderd en opnieuw is toegevoegd, respectievelijk. Maar de symbolen zijn daadwerkelijk verwijderd en toegevoegd, dus ze zijn opgenomen in de verzameling.

Als de TextChanged gebeurtenis optreedt als gevolg van een eigenschapswijziging, Changes is dit een lege verzameling. Als de gebruiker in het voorgaande voorbeeld de hele tekenreeks vetdrukt, wordt de FontWeight eigenschap van de Run tekenreeks ingesteld op Bold, maar er wordt niets toegevoegd aan of verwijderd uit het document, dus Changes leeg.

Changes wordt geïntroduceerd in de .NET Framework versie 3.5. Zie Versies en afhankelijkheden voor meer informatie.