ModelItem-Klasse

Stellt ein einzelnes Element im Bearbeitungsmodell dar.

Vererbungshierarchie

System.Object
  Microsoft.Windows.Design.Model.ModelItem
    Microsoft.Windows.Design.Model.ModelItemCollection
    Microsoft.Windows.Design.Model.ModelItemDictionary

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

Syntax

'Declaration
Public MustInherit Class ModelItem _
    Implements INotifyPropertyChanged

public abstract class ModelItem : INotifyPropertyChanged

public ref class ModelItem abstract : INotifyPropertyChanged

[<AbstractClass>]
type ModelItem =  
    class
        interface INotifyPropertyChanged
    end

public abstract class ModelItem implements INotifyPropertyChanged

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

Konstruktoren

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

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	Content	Ruft beim Überschreiben in einer abgeleiteten Klasse eine ModelProperty ab, die das ContentPropertyAttribute des Elements darstellt.
	Context	Ruft ein Objekt ab, das Kontextinformationen über den Designer enthält, für den dieses ModelItem erstellt wurde.
	Events	Ruft beim Überschreiben in einer abgeleiteten Klasse die öffentlichen Ereignisse für dieses Objekt ab.
	ItemType	Ruft beim Überschreiben in einer abgeleiteten Klasse den Typ des Objekts ab, das dieses Element darstellt.
	Name	Ruft beim Überschreiben in einer abgeleiteten Klasse den Namen oder die ID des Elements ab oder legt diese fest.
	Parent	Ruft beim Überschreiben in einer abgeleiteten Klasse das Element ab, das diesem Element übergeordnet ist.
	Properties	Ruft beim Überschreiben in einer abgeleiteten Klasse die öffentlichen Eigenschaften für dieses Objekt ab.
	Root	Ruft beim Überschreiben in einer abgeleiteten Klasse das Element ab, das der Stamm der Struktur ist.
	Source	Ruft beim Überschreiben in einer abgeleiteten Klasse die Eigenschaft ab, die diesen Wert zur Verfügung stellt.
	View	Ruft beim Überschreiben in einer abgeleiteten Klasse die Visual-Klasse oder Visual3D-Klasse ab, die die Benutzeroberfläche für dieses Element darstellt.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	BeginEdit()	Ruft beim Überschreiben in einer abgeleiteten Klasse diese Methode auf, wenn mehrere Vorgänge für ein Objekt oder eine Gruppe von Objekten durchgeführt werden.
	BeginEdit(String)	Ruft beim Überschreiben in einer abgeleiteten Klasse diese Methode auf, wenn mehrere Vorgänge für ein Objekt oder eine Gruppe von Objekten durchgeführt werden.
	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.)
	GetAttributes(Type)	Ruft die Attribute des angeforderten Typs ab, die für dieses Element deklariert sind.
	GetAttributes(TypeIdentifier)	Ruft die Attribute des angeforderten Typs ab, die für dieses Element deklariert sind.
	GetCurrentValue	Gibt beim Überschreiben in einer abgeleiteten Klasse den aktuellen Wert des zugrunde liegenden Modellobjekts zurück, das das ModelItem umschließt.
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	IsItemOfType(Type)	Ruft einen Wert ab, der angibt, ob dieses Element vom angegebenen Typ ist oder die angegebene Schnittstelle implementiert.
	IsItemOfType(TypeIdentifier)	Ruft einen Wert ab, der angibt, ob dieses Element vom angegebenen Typ ist oder die angegebene Schnittstelle implementiert.
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	PropertyChanged	Tritt beim Überschreiben in einer abgeleiteten Klasse auf, wenn sich eine Eigenschaft für das Modell ändert.

Zum Seitenanfang

Hinweise

Die ModelItem-Klasse stellt ein einzelnes Element im Bearbeitungsmodell dar. Dieses Element kann beispielsweise ein Fenster oder ein Steuerelement sein, aber auch eine Farbe oder eine ganze Zahl. Sie können über die Properties-Auflistung auf die Eigenschaften des Elements zugreifen und Änderungen an den Werten für diese Eigenschaft vornehmen. Ein ModelItem ist im Grunde ein Wrapper um das dem Designer zugrundeliegende Datenmodell. Sie können über die GetCurrentValue-Methode auf das zugrunde liegende Modell zugreifen.

Verwenden Sie immer die CreateItem-Methode, um neue Objekte auf der Entwurfsoberfläche zu erstellen. Dies ist erforderlich, da viele unformatierte Instanzen nicht in Modellelemente aufgelöst werden können. Sobald ein Wert im Modell festgelegt wurde, sollten Sie nur über das Modell mit dem Wert interagieren. Die Instanz, die das Modell unterstützt, kann jederzeit vom Framework neu erstellt werden, wodurch alle zwischengespeicherten Verweise ungültig werden.

Tipp

Sie sollten keine serialisierbaren Änderungen an einem Objekt vornehmen, das von der GetCurrentValue-Methode zurückgegeben wird. Die Änderungen werden bei der Serialisierung des Designers oder bei Systemen zum Rückgängigmachen nicht reflektiert.

Tipp

Verwenden Sie die unveränderliche Kultur, wenn Sie Werte von Modellelementen mit Zeichenfolgen festlegen.

Threadsicherheit

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

Siehe auch

Referenz

Microsoft.Windows.Design.Model-Namespace

Weitere Ressourcen

Erweiterbare Architektur des WPF-Designers

Bearbeitungsmodellarchitektur