ModelItem Třída

Definice

Obor názvů:

System.Activities.Presentation.Model

Sestavení:

System.Activities.Presentation.dll

Představuje jednu položku v modelu úprav. Položka může být cokoli od složité datové struktury až po barvu nebo celé číslo.

public ref class ModelItem abstract : System::ComponentModel::INotifyPropertyChanged

public abstract class ModelItem : System.ComponentModel.INotifyPropertyChanged

type ModelItem = class
    interface INotifyPropertyChanged

Public MustInherit Class ModelItem
Implements INotifyPropertyChanged

Dědičnost

Object

ModelItem

Odvozené

System.Activities.Presentation.Model.ModelItemCollection

System.Activities.Presentation.Model.ModelItemDictionary

Implementuje

INotifyPropertyChanged

Příklady

Objekt ModelItem lze považovat za tenkou proxy pro objekt, na který ukazuje. Nejprve definujte jednoduchý Animal objekt.

public class Animal  
{  
    // simple property  
    public string Name { get; set; }  
    // complex property   
    public Location Residence { get; set; }   
    // list   
    public List<Animal> CloseRelatives { get; set; }  
    // dictionary  
    public Dictionary<string, object> Features { get; set; }   
}  

public class Location  
{  
    public string StreetAddress { get; set; }  
    public string City { get; set; }  
    public string State { get; set; }   
}  

Za druhé vytvořte instanci tohoto objektu AnimalModelItem a , který je pro něj proxy. Objekt se pak dá načíst voláním GetCurrentValuemetody . Následující kód také ukazuje, jak používat další vlastnosti definované nástrojem ModelItem.

EditingContext ec = new EditingContext();  
var companion1 = new Animal { Name = "Houdini the parakeet" };  
var companion2 = new Animal { Name = "Groucho the fish" };  
var animal = new Animal   
   {  
      Name = "Sasha the pug",  
      Residence = new Location   
      {  
         StreetAddress = "123 Main Street",  
         City = "AnyTown",  
         State = "Washington"  
      },  
      Features = new Dictionary<string, object> {   
         {"noise", "snort" },  
         {"MeanTimeUntilNaps", TimeSpan.FromMinutes(15) }  
      },  
      CloseRelatives = new List<Animal> { companion1, companion2 }   
   };  
ModelTreeManager mtm = new ModelTreeManager(ec);  mtm.Load(animal);  
ModelItem mi = mtm.Root;  

//Testing other properties of the class  
ModelItem root = mtm.Root;  
Assert.IsTrue(root.GetCurrentValue() == animal, "GetCurrentValue() returns same object");  
Assert.IsTrue(root.ItemType == typeof(Animal),"ItemType describes the item");  
Assert.IsTrue(root.Parent == null,"root parent is null");  
Assert.IsTrue(root.Source == null, "root source is null");  
Assert.IsTrue(((List<Animal>)root.Properties["CloseRelatives"].ComputedValue)[0] == companion1,   
   "ComputedValue of prop == actual object");  
Assert.IsFalse(((List<Animal>)root.Properties["CloseRelatives"].ComputedValue)[0] == companion2,   
   "ComputedValue of prop == actual object");  
Assert.AreEqual(root.Properties["Residence"].  
   Value.  
   Properties["StreetAddress"].  
   Value.GetCurrentValue(), "123 Main Street", "get actual value back out");  
Assert.AreEqual(root, root.Properties["Residence"].Parent, "property points to owner");  
ModelItem location = root.Properties["Residence"].Value;  
Assert.AreEqual(root.Properties["Residence"], location.Source, "sources point to the right place");  

Poznámky

K vlastnostem položky můžete přistupovat prostřednictvím její Properties kolekce a měnit hodnoty vlastností.

Objekt ModelItem je obálka kolem podkladového datového modelu návrháře. K podkladovému modelu můžete přistupovat prostřednictvím GetCurrentValue metody .

Poznámka

Jakékoli změny provedené v objektu vrácené z GetCurrentValue metody se neprojeví serializace a vrácení zpět systémy návrháře.

Konstruktory

ModelItem()

Vytvoří novou instanci třídy ModelItem.

Vlastnosti

Attributes	Získá atributy deklarované na této položce.
Content	Získá z ContentPropertyAttribute položky nebo null.
ItemType	Získá typ objektu, který položka představuje.
Name	Získá nebo nastaví název nebo ID položky.
Parent	Získá položku, která je nadřazená této položce.
Parents	Získá všechny nadřazené položky.
Properties	Získá veřejné vlastnosti této položky.
Root	Získá položku, která je kořenem tohoto stromu.
Source	Získá vlastnost, která poskytla tuto hodnotu.
Sources	Získá všechny vlastnosti, které obsahují tuto hodnotu.
View	Získá, DependencyObject který graficky představuje tuto položku.

Metody

BeginEdit()	Otevře obor úprav pro návrháře. Po otevření oboru úprav budou všechny změny ve všech objektech uloženy do rozsahu, dokud se transakce nedokončí nebo nevrátí zpět. Úpravy oborů mohou být vnořené, ale musí být potvrzeny v pořadí.
BeginEdit(Boolean)	Otevře obor úprav pro návrháře.
BeginEdit(String)	Otevře obor úprav pro návrháře. Po otevření oboru úprav budou všechny změny ve všech objektech uloženy do rozsahu, dokud se transakce nedokončí nebo nevrátí zpět. Úpravy oborů mohou být vnořené, ale musí být potvrzeny v pořadí.
BeginEdit(String, Boolean)	Otevře obor úprav pro návrháře.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetCurrentValue()	Vrátí aktuální hodnotu objektu podkladového modelu, který ModelItem se zalamuje.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězcovou reprezentaci objektu podkladového modelu obsaženého v této položce modelu.

Událost

PropertyChanged

Implementuje INotifyPropertyChanged. Tato událost slouží k naslouchání změnám modelu. Používají ho také funkce datové vazby WPF.

Metody rozšíření

Focus(ModelItem)	Nastaví fokus klávesnice na zadanou položku návrháře.
Focus(ModelItem, Int32)	Nastaví fokus klávesnice na zadanou položku návrháře.
GetEditingContext(ModelItem)	Načte kontext úprav zadané položky modelu.
GetModelPath(ModelItem)	Načte cestu k zadané položce modelu.
IsParentOf(ModelItem, ModelItem)	Vrátí hodnotu, která označuje, zda první zadaná položka návrháře je nadřazená druhé zadané položky návrháře.