ContextItem-Klasse

Článek
08/23/2008

Aktualisiert: November 2007

Stellt einen einzelnen Bestandteil des Zustands im Designer dar.

Namespace: Microsoft.Windows.Design
Assembly: Microsoft.Windows.Design (in Microsoft.Windows.Design.dll)

Syntax

'Declaration
Public MustInherit Class ContextItem
'Usage
Dim instance As ContextItem

public abstract class ContextItem

public ref class ContextItem abstract

public abstract class ContextItem

Hinweise

Kontextelemente sind unveränderliche Objekte, die den Zustand enthalten. Mit einigen Kontextelementen werden außerdem Methoden definiert, die Operationen auf den Zustand ausführen können, den sie enthalten. ContextItem ist die Basisklasse, von der alle Kontextelemente abgeleitet werden müssen.

Ein Kontextelement kommt und geht möglicherweise in einen Bearbeitungskontext. Kontextelemente sind flüchtig, sie verfügen jedoch immer über einen Wert. Auch wenn ein bestimmtes Kontextelement sich nicht im Kontext befindet, wird immer ein Standardwert bereitgestellt. Daher gibt der Kontext niemals nullNULL-Verweis (Nothing in Visual Basic) zurück.

Im Gegensatz zu einem Dienst kann sich der Wert eines Kontextelements jederzeit ändern. Deshalb sollten Kontextelemente nicht zwischengespeichert werden. Code, der den Kontext verwendet, kann einen SubscribeContextCallback<ContextItemType> abonnieren, der ausgelöst wird, sobald ein bestimmter Typ von Kontextelement geändert wird.

Eine von ContextItem abgeleitete Klasse muss einen leeren Konstruktor definieren. Diese leere Konstruktorversion eines Kontextelements stellt seinen Standardwert dar. Dieser Standardwert ist der Wert, der von GetValue zurückgegeben wird, wenn ContextItemManager kein Kontextelement des angeforderten Typs enthält.

Vererbungshierarchie

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.