ModelItem Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет один элемент в модели редактирования. Элемент может быть чем угодно — от сложной структуры данных до цвета или целого числа.
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
- Наследование
-
ModelItem
- Производный
- Реализации
Примеры
Объект класса ModelItem может рассматриваться как «тонкий» прокси-сервер для объекта, на который он указывает. Сначала создайте простой объект 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; }
}
Затем создайте экземпляр этого объекта Animal
и объект класса ModelItem, который является для него прокси-сервером. Объект может быть получен с помощью метода GetCurrentValue. В следующем примере кода также демонстрируется использование других свойств, которые определяются объектом 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");
Комментарии
Вы можете получить доступ к свойствам элемента через его Properties коллекцию и внести изменения в значения свойств.
Объект класса ModelItem является оболочкой вокруг модели базовых данных конструктора. Доступ к базовой модели можно получить с помощью метода GetCurrentValue.
Примечание
Любые внесенные в объект изменения, которые возвращаются из метода GetCurrentValue, не будут отражены сериализацией и отменят системы конструктора.
Конструкторы
ModelItem() |
Создает новый экземпляр класса ModelItem. |
Свойства
Attributes |
Получает атрибуты, объявленные в этом элементе. |
Content |
Получает |
ItemType |
Получает тип объекта, который представляет элемент. |
Name |
Получает или задает имя или идентификатор элемента. |
Parent |
Получает элемент, который является родительским по отношению к этому элементу. |
Parents |
Получает все родительские объекты этого элемента. |
Properties |
Получает открытые свойства в этом элементе. |
Root |
Получает элемент, который является корневым элементом этого дерева. |
Source |
Получает свойство, которое предоставляет это значение. |
Sources |
Получает все свойства, которые содержат это значение. |
View |
Получает объект DependencyObject, который представляет этот элемент в графическом виде. |
Методы
BeginEdit() |
Открывает область редактирования для конструктора. Когда область редактирования открыта, все изменения всех объектов хранятся в этой области до завершения транзакции или отмены изменений. Области редактирования могут быть вложенными, но должны фиксироваться по порядку. |
BeginEdit(Boolean) |
Открывает область редактирования для конструктора. |
BeginEdit(String) |
Открывает область редактирования для конструктора. Когда область редактирования открыта, все изменения всех объектов хранятся в этой области до завершения транзакции или отмены изменений. Области редактирования могут быть вложенными, но должны фиксироваться по порядку. |
BeginEdit(String, Boolean) |
Открывает область редактирования для конструктора. |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetCurrentValue() |
Возврат текущего значения объекта базовой модели, для которого объект класса ModelItem является оболочкой. |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ToString() |
Возвращает строковое представление объекта базовой модели, которое содержится в этом элементе модели. |
События
PropertyChanged |
Реализовывать объект |
Методы расширения
Focus(ModelItem) |
Задает фокус клавиатуры для указанного элемента конструктора. |
Focus(ModelItem, Int32) |
Задает фокус клавиатуры для указанного элемента конструктора. |
GetEditingContext(ModelItem) |
Возвращает контекст редактирования указанного элемента модели. |
GetModelPath(ModelItem) |
Возвращает путь указанного элемента модели. |
IsParentOf(ModelItem, ModelItem) |
Возвращает значение, указывающее, является ли первый заданный элемент конструктора родительским объектом второго заданного элемента конструктора. |