ContextItem 类

更新:2007 年 11 月

表示设计器中的一个状态。

命名空间:  Microsoft.Windows.Design
程序集:  Microsoft.Windows.Design(在 Microsoft.Windows.Design.dll 中)

语法

声明
Public MustInherit Class ContextItem
用法
Dim instance As ContextItem
public abstract class ContextItem
public ref class ContextItem abstract
public abstract class ContextItem

备注

上下文项是包含状态的不可变对象。一些上下文项还定义了可对它们包含的状态进行操作的方法。ContextItem 是基类,所有上下文项都必须从中派生。

上下文项可存在于编辑上下文中。上下文项是瞬态的,但它们始终有一个值。即使某个特定的上下文项不在上下文中,仍会始终提供一个默认值。因此,上下文永远不会返回 nullnull 引用(在 Visual Basic 中为 Nothing)。

与服务不同的是,上下文项的值可以随时更改。这表示,不应缓存上下文项。使用上下文的代码可以订阅 SubscribeContextCallback<ContextItemType>,它在特定类型的上下文项发生更改时引发。

从 ContextItem 派生的类必须定义一个空构造函数。上下文项的这一空构造函数版本表示其默认值。此默认值是当 ContextItemManager 不包含所请求类型的上下文项时,从 GetValue 返回的值。

继承层次结构

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

线程安全

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

另请参见

参考

ContextItem 成员

Microsoft.Windows.Design 命名空间

ContextItemManager

SubscribeContextCallback<ContextItemType>

ServiceManager

FeatureManager

其他资源

编辑上下文体系结构

了解 WPF 设计器扩展性