ModelItem Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 |
|
| 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 |
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. |