ModelItem Třída

Definice

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

Příklady

Lze ModelItem si představit jako tenký proxy pro objekt, na kterém odkazuje. 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 této Animal instance a ModelItem to je proxy server pro něj. 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 své Properties kolekce a provádět změny hodnot vlastností.

A 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.

Note

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

Konstruktory

Name Description
ModelItem()

Vytvoří novou instanci ModelItem třídy.

Vlastnosti

Name Description
Attributes

Získá atributy deklarované pro tuto položku.

Content

ContentPropertyAttribute Získá položku 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á grafické znázornění DependencyObject této položky.

Metody

Name Description
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 je zabalen.

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

Name Description
PropertyChanged

Implementuje INotifyPropertyChanged. Tato událost slouží k naslouchání změnám modelu. Používá se také funkce datových vazeb WPF (Windows Presentation Foundation).

Metody rozšíření

Name Description
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.

Platí pro