ContextItem, classe

Article
08/10/2011

Représente un état unique dans le concepteur.

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

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

Syntaxe

'Déclaration
Public MustInherit Class ContextItem

public abstract class ContextItem

public ref class ContextItem abstract

[<AbstractClass>]
type ContextItem =  class end

public abstract class ContextItem

Le type ContextItem expose les membres suivants.

Constructeurs

	Nom	Description
	ContextItem	Initialise une nouvelle instance de la classe ContextItem.

Début

Propriétés

	Nom	Description
	ItemType	En cas de substitution dans une classe dérivée, ce membre reçoit le type d'élément pour cet élément de contexte d'édition.

Début

Méthodes

	Nom	Description
	Equals	Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	MemberwiseClone	Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
	OnItemChanged	Appelé sur un élément de contexte avant qu'il ne soit stocké dans le gestionnaire de l'élément de contexte.
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

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 permettent d'exécuter des opérations sur l'état contenu. ContextItem est la classe de base de laquelle tous les éléments de contexte doivent dériver.

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<TContextItemType> 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é.

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.