TextChangedEventArgs.Changes Vlastnost

Definice

Obor názvů:

System.Windows.Controls

Sestavení:

PresentationFramework.dll

Získá kolekci objektů, které obsahují informace o změnách, ke kterým došlo.

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)

Hodnota vlastnosti

ICollection<TextChange>

Kolekce objektů, které obsahují informace o změnách, ke kterým došlo.

Poznámky

Pro každou po sobě jdoucí změnu ovládacího prvku je jeden TextChange objekt. Během jednoho výskytu TextChanged události může dojít k více než jedné po sobě jdoucí změně, pokud změna zahrnuje změnu struktury podkladového dokumentu.

Předpokládejme například, že RichTextBox obsahuje řetězec "This is some text." Struktura RichTextBox.Document je <Paragraph><Run>This is some text.</Run></Paragraph>. Pokud uživatel tučně změní strukturu podkladových FlowDocument změn "is some"na <Paragraph><Run>This </Run><Run FontWeight="Bold">is some</Run><Run> text.</Run></Paragraph>. V důsledku akce uživatele se skutečně provedly čtyři změny:

1. Symbol <Run> se odebere a znovu přidá před slovo This.

2. Symboly </Run><Run> se přidají za slovo This.

3. Symboly </Run><Run> se přidají za slovo some.

4. Symbol </Run> se odebere a znovu přidá za slovo Text.

Obecně platí následující:

• Změny, ke kterým dojde, způsobí, že dokument je v platném stavu.

• Kolekce se řadí po sobě, a to v souvislosti s místem, kde došlo ke změně v ovládacím prvku. Například TextChange objekt, který představuje změnu na pozici 2, je před TextChange objektem, který představuje změnu na pozici 10.

• Dva TextChange objekty nepředstavují překrývající se oblast. Hodnota plus hodnota OffsetAddedLength jednoho TextChange objektu je vždy menší nebo rovna hodnotě Offset dalšího TextChange objektu v kolekci. Stejně tak je hodnota Offset plus hodnota RemovedLength jednoho TextChange objektu vždy menší nebo rovna hodnotě dalšího OffsetTextChange objektu v kolekci.

• Kolekce odráží všechny změny, ke kterým došlo, i když se zdá, že nedošlo k žádné čisté změně. V předchozím příkladu ani první nebo čtvrtá změna nemá za následek čistou změnu, protože každá jednoduše odebrala a znovu přidala <Run> symboly a </Run> symboly. Ale symboly byly skutečně odebrány a přidány, takže jsou zahrnuty do kolekce.

Pokud dojde k TextChanged události v důsledku změny vlastnosti, Changes je prázdná kolekce. V předchozím příkladu, pokud uživatel tučným písmem celý řetězec, FontWeight vlastnost objektu Run je nastavena na Bold, ale nic není přidáno nebo odebráno z dokumentu, takže Changes je prázdná.

Changes je zaveden v rozhraní .NET Framework verze 3.5. Další informace naleznete v tématu Verze a závislosti.