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 dolů na 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

ModelItem lze považovat za tenký proxy objekt, na kterém odkazuje. Nejprve definujte jednoduchý objekt Animal.

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 této Animal a ModelItem, která je pro ni proxy serverem. Objekt lze pak načíst voláním GetCurrentValue. Následující kód také ukazuje, jak používat další vlastnosti definované 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 jeho Properties kolekce a provádět změny hodnot vlastností.

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

Poznámka

Všechny změny provedené u objektu vráceného z metody GetCurrentValue se neprojeví serializací a vrácením zpět systémů návrháře.

Konstruktory

ModelItem()

Vytvoří novou instanci třídy ModelItem.

Vlastnosti

Attributes	Získá atributy deklarované pro tuto položku.
Content	Získá 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řazenou položkou této položky.
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 návrháře. Po otevření oboru úprav budou všechny změny ve všech objektech uloženy do oboru, dokud transakce nebude dokončena nebo vrácena zpět. Obory úprav lze vnořit, ale musí být potvrzeny v pořadí.
BeginEdit(Boolean)	Otevře obor úprav návrháře.
BeginEdit(String, Boolean)	Otevře obor úprav návrháře.
BeginEdit(String)	Otevře obor úprav návrháře. Po otevření oboru úprav budou všechny změny ve všech objektech uloženy do oboru, dokud transakce nebude dokončena nebo vrácena zpět. Obory úprav lze vnořit, ale musí být potvrzeny v pořadí.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetCurrentValue()	Vrátí aktuální hodnotu základního objektu modelu, který ModelItem obtéká.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězcovou reprezentaci základního objektu 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žívá se také funkce datových vazeb WPF.

Metody rozšíření

Focus(ModelItem, Int32)	Nastaví fokus klávesnice na zadanou položku návrháře.
Focus(ModelItem)	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 zadané položky modelu.
IsParentOf(ModelItem, ModelItem)	Vrátí hodnotu, která určuje, zda první zadaná položka návrháře je nadřazenou druhou zadanou položkou návrháře.