ContextItem, classe

Mise à jour : novembre 2007

Représente un état unique dans le concepteur.

Espace de noms : Microsoft.Windows.Design
Assembly : Microsoft.Windows.Design (dans Microsoft.Windows.Design.dll)

Syntaxe

Public MustInherit Class ContextItem

Dim instance As ContextItem

public abstract class ContextItem

public ref class ContextItem abstract

public abstract class ContextItem

Notes

Les éléments de contexte sont des objets immuables qui contiennent un état. Certains éléments de contexte définissent également des méthodes qui peuvent effectuer des opérations sur l'état qu'ils contiennent. ContextItem est la classe de base dont doivent dériver tous les éléments de contexte.

Un élément de contexte peut aller et venir dans un contexte d'édition. Les éléments de contexte sont transitoires, mais ils possèdent toujours une valeur. Même si un élément de contexte particulier n'est pas dans le contexte, une valeur par défaut est toujours fournie. Par conséquent, le contexte ne retourne jamais nullune référence null (Nothing en Visual Basic).

Contrairement à un service, la valeur d'un élément de contexte peut changer à tout moment. Cela signifie que vous ne devez pas mettre en cache les éléments de contexte. Le code qui utilise le contexte peut s'abonner à un SubscribeContextCallback<ContextItemType> déclenché lors de la modification d'un type particulier d'élément de contexte.

Une classe dérivée de ContextItem doit définir un constructeur vide. Ce constructeur vide d'un élément de contexte représente sa valeur par défaut. Cette valeur par défaut est retournée par GetValue si le ContextItemManager ne contient pas un élément de contexte du type demandé.

Hiérarchie d'héritage

System.Object
  Microsoft.Windows.Design.ContextItem
    Microsoft.Windows.Design.AssemblyReferences
    Microsoft.Windows.Design.Interaction.CurrentDesignerView
    Microsoft.Windows.Design.Interaction.FocusedTask
    Microsoft.Windows.Design.Interaction.Selection
    Microsoft.Windows.Design.Interaction.Tool

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.