TextChangedEventArgs.Changes Свойство

Определение

Пространство имен:

System.Windows.Controls

Сборка:

PresentationFramework.dll

Возвращает коллекцию объектов, содержащих сведения об изменениях, произошедших.

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)

Значение свойства

ICollection<TextChange>

Коллекция объектов, содержащих сведения об изменениях, произошедших.

Комментарии

Существует один TextChange объект для каждого последовательного изменения элемента управления. При изменении структуры базового документа может произойти несколько последовательных изменений во время одного вхождения TextChanged события.

Например, предположим, что a RichTextBox содержит строку "This is some text." Структура объекта RichTextBox.Document<Paragraph><Run>This is some text.</Run></Paragraph>. Если пользователь полужирает слова "is some", структура базовых FlowDocument изменений <Paragraph><Run>This </Run><Run FontWeight="Bold">is some</Run><Run> text.</Run></Paragraph>. В результате действия пользователя на самом деле произошло четыре изменения:

1. Символ <Run> удаляется и повторно добавляется перед словом This.

2. Символы </Run><Run> добавляются после слова This.

3. Символы </Run><Run> добавляются после слова some.

4. Символ </Run> удаляется и повторно добавляется после слова Text.

Как правило, следующие значения всегда будут иметь значение true:

• Изменения, которые происходят, приводят к тому, что документ будет находиться в допустимом состоянии.

• Коллекция упорядочена последовательно, связана с тем, где произошло изменение в элементе управления. Например, объект, TextChange представляющий изменение позиции 2, перед TextChange объектом, который представляет изменение в позиции 10.

• Два TextChange объекта не представляют перекрывающейся области. Значение плюс значение OffsetAddedLength одного TextChange объекта всегда меньше или равно значению Offset следующего TextChange объекта в коллекции. Аналогичным образом, значение плюс значение OffsetRemovedLength одного TextChange объекта всегда меньше или равно значению Offset следующего TextChange объекта в коллекции.

• Коллекция отражает любые изменения, даже если нет никаких чистых изменений. В предыдущем примере ни первое или четвертое изменение не приводит к чистому изменению, так как каждая из них просто удаляется и повторно добавляет <Run></Run> символы соответственно. Но символы были на самом деле удалены и добавлены, поэтому они включены в коллекцию.

TextChanged Если событие происходит в результате изменения свойства, Changes это пустая коллекция. В предыдущем примере, если пользователь полужирен всю строку, FontWeight свойство Run объекта задано Bold, но ничего не добавляется или удаляется из документа, поэтому Changes пусто.

Changes представлен в .NET Framework версии 3.5. Дополнительные сведения см. в разделе "Версии и зависимости".