Sdílet prostřednictvím


ModelItem Třída

Definice

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
ModelItem
Odvozené
Implementuje

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.

Platí pro