ContextItem-Klasse

Artikel
08/10/2011

Stellt einen einzelnen Bestandteil des Zustands im Designer dar.

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

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

Syntax

'Declaration
Public MustInherit Class ContextItem

public abstract class ContextItem

public ref class ContextItem abstract

[<AbstractClass>]
type ContextItem =  class end

public abstract class ContextItem

Der ContextItem-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	ContextItem	Initialisiert eine neue Instanz der ContextItem-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	ItemType	Ruft den Elementtyp für das entsprechende Bearbeitungskontextelement ab, wenn in einer abgeleiteten Klasse überschrieben.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Equals	Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	OnItemChanged	Wird in einem Kontextelement aufgerufen, bevor es im ContextItemManager gespeichert wird.
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Hinweise

Kontextelemente sind unveränderliche Objekte, die den Zustand enthalten. Einige Kontextelemente definieren auch Methoden, die Operationen für 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<TContextItemType> 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.

Threadsicherheit

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