TextChangedEventArgs.Changes Propriété

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtient une collection d’objets qui contient des informations sur les modifications qui se sont produites.

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)

Valeur de propriété

ICollection<TextChange>

Collection d’objets qui contient des informations sur les modifications qui se sont produites.

Remarques

Il existe un TextChange objet pour chaque modification consécutive du contrôle. Plusieurs modifications consécutives peuvent se produire lors d’une occurrence de l’événement TextChanged lorsque la modification implique de modifier la structure du document sous-jacent.

Par exemple, supposons qu’une RichTextBox chaîne "This is some text." contient la structure de l’objet RichTextBox.Document<Paragraph><Run>This is some text.</Run></Paragraph>. Si l’utilisateur met en gras les mots "is some", la structure des modifications sous-jacentes FlowDocument à <Paragraph><Run>This </Run><Run FontWeight="Bold">is some</Run><Run> text.</Run></Paragraph>. Il existe en fait quatre modifications qui ont eu lieu suite à l’action de l’utilisateur :

1. Le <Run> symbole est supprimé et re-ajouté avant le mot This.

2. Les symboles sont ajoutés </Run><Run> après le mot This.

3. Les symboles sont ajoutés </Run><Run> après le mot some.

4. Le </Run> symbole est supprimé et re-ajouté après le mot Text.

En règle générale, les éléments suivants sont toujours vrais :

• Les modifications qui se produisent entraînent l’état valide du document.

• La collection est ordonnée consécutivement, liée à l’emplacement où la modification s’est produite dans le contrôle. Par exemple, un TextChange objet qui représente une modification à la position 2 est avant un TextChange objet qui représente une modification à la position 10.

• Deux TextChange objets ne représentent pas une zone qui se chevauche. La valeur de Offset plus la valeur d’un TextChangeAddedLength objet est toujours inférieure ou égale à la valeur de Offset l’objet suivant TextChange dans la collection. De même, la valeur de Offset plus la valeur d’un TextChangeRemovedLength objet est toujours inférieure ou égale à la valeur de Offset l’objet suivant TextChange dans la collection.

• La collection reflète les modifications qui se sont produites, même s’il semble qu’il n’y ait aucune modification nette. Dans l’exemple précédent, ni le premier ou le quatrième changement n’entraînent une modification nette, car chaque simple suppression et ajout <Run></Run> des symboles, respectivement. Mais les symboles ont été réellement supprimés et ajoutés, de sorte qu’ils sont inclus dans la collection.

Si l’événement TextChanged se produit à la suite d’une modification de propriété, Changes est une collection vide. Dans l’exemple précédent, si l’utilisateur met en gras la chaîne entière, la FontWeight propriété du Run fichier est définie Boldsur , mais rien n’est ajouté ou supprimé du document. Il est donc Changes vide.

Changes est introduit dans .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances.