TextChangedEventArgs.Changes Egenskap

Definition

Namnområde:
System.Windows.Controls
Sammansättning:
PresentationFramework.dll

Hämtar en samling objekt som innehåller information om de ändringar som har inträffat.

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)

Egenskapsvärde

ICollection<TextChange>

En samling objekt som innehåller information om de ändringar som har inträffat.

Kommentarer

Det finns ett TextChange objekt för varje efterföljande ändring av kontrollen. Mer än en på varandra följande ändring kan inträffa under en förekomst av TextChanged händelsen när ändringen innebär att strukturen för det underliggande dokumentet ändras.

Anta till exempel att en RichTextBox innehåller strängen "This is some text." Strukturen för RichTextBox.Document är <Paragraph><Run>This is some text.</Run></Paragraph>. Om användaren fetstilar orden "is some"ändras strukturen för underliggande FlowDocument till <Paragraph><Run>This </Run><Run FontWeight="Bold">is some</Run><Run> text.</Run></Paragraph>. Det finns faktiskt fyra ändringar som har gjorts till följd av användarens åtgärd:

  1. Symbolen <Run> tas bort och läggs till igen före ordet This.

  2. Symbolerna </Run><Run> läggs till efter ordet This.

  3. Symbolerna </Run><Run> läggs till efter ordet some.

  4. Symbolen </Run> tas bort och läggs till igen efter ordet Text.

I allmänhet är följande alltid sant:

  • Ändringarna som sker resulterar i att dokumentet är i ett giltigt tillstånd.

  • Samlingen sorteras i följd, relaterat till var ändringen inträffade i kontrollen. Ett objekt som till exempel TextChange representerar en ändring vid position 2 är före ett TextChange objekt som representerar en ändring vid position 10.

  • Två TextChange objekt representerar inte ett överlappande område. Värdet för Offset plus värdet AddedLength för ett TextChange objekt är alltid mindre än eller lika med värdet Offset för nästa TextChange objekt i samlingen. På samma sätt är värdet Offset för plus värdet RemovedLength för ett TextChange objekt alltid mindre än eller lika med värdet Offset för nästa TextChange objekt i samlingen.

  • Samlingen återspeglar de ändringar som har gjorts, även om det inte verkar finnas någon nettoändring. I föregående exempel resulterar varken den första eller fjärde ändringen i en nettoändring, eftersom var och en helt enkelt har tagit bort respektive lagt till symbolerna <Run> och </Run> igen. Men symbolerna togs faktiskt bort och lades till, så de ingår i samlingen.

Om händelsen TextChanged inträffar till följd av en egenskapsändring Changes är en tom samling. I föregående exempel, om användaren fetstilar hela strängen FontWeight , är egenskapen för Run egenskapen inställd på , men ingenting läggs till Boldeller tas bort från dokumentet, så Changes är tom.

Changes introduceras i .NET Framework version 3.5. Mer information finns i Versioner och beroenden.

Gäller för