ContextItem - класс

Статья
08/11/2011

Представляет одну часть состояния конструктора.

Иерархия наследования

System.Object
  Microsoft.Windows.Design.ContextItem
    Microsoft.Windows.Design.AssemblyReferences
    Microsoft.Windows.Design.Interaction.CurrentDesignerView
    Microsoft.Windows.Design.Interaction.FocusedTask
    Microsoft.Windows.Design.Interaction.Selection
    Microsoft.Windows.Design.Interaction.Tool

Пространство имен: Microsoft.Windows.Design
Сборка: Microsoft.Windows.Design.Extensibility (в Microsoft.Windows.Design.Extensibility.dll)

Синтаксис

'Декларация
Public MustInherit Class ContextItem

public abstract class ContextItem

public ref class ContextItem abstract

[<AbstractClass>]
type ContextItem =  class end

public abstract class ContextItem

Тип ContextItem предоставляет следующие члены.

Конструкторы

	Имя	Описание
	ContextItem	Инициализирует новый экземпляр класса ContextItem.

В начало страницы

Свойства

	Имя	Описание
	ItemType	При переопределении в производном классе получает тип элемента для этого элемента контекста редактирования.

В начало страницы

Методы

	Имя	Описание
	Equals	Определяет, равен ли заданный объект Object текущему объекту Object. (Унаследовано от Object.)
	Finalize	Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.)
	GetHashCode	Играет роль хэш-функции для определенного типа. (Унаследовано от Object.)
	GetType	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.)
	MemberwiseClone	Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
	OnItemChanged	Элемент контекста вызывается перед его сохранением в диспетчерах элементов контекста.
	ToString	Возвращение строки, представляющей текущий объект. (Унаследовано от Object.)

В начало страницы

Заметки

Элементы контекста являются неизменяемыми объектами, содержащими состояние. Некоторые элементы контекста также определяют методы, которые могут выполнять операции над содержащимся в этих элементах состоянием. ContextItem — это базовый класс, от которого должны наследоваться все элементы контекста.

Элемент контекста может добавляться в контекст редактирования и удаляться из него. Элементы контекста являются временными, но они всегда имеют значение. Даже если конкретный элемент контекста отсутствует в контексте, всегда предоставляется значение по умолчанию. Поэтому контекст никогда не возвращает значение nullпустая ссылка (Nothing в Visual Basic).

В отличие от службы значение элемента контекста может измениться в любой момент. Это означает, что не следует кэшировать элементы контекста. Код, использующий контекст, может подписаться на объект SubscribeContextCallback<TContextItemType>, который вызывается при изменении определенного типа элемента контекста.

Класс, производный от ContextItem, должен определить пустой конструктор. В этой версии пустого конструктора для элемента контекста используется его значение по умолчанию. Значение элемента контекста по умолчанию — это значение, возвращаемое из GetValue, если ContextItemManager не содержит элемент контекста запрашиваемого типа.

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.