DesignerActionService 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
建立管理组件的 DesignerActionItem 对象集合的设计时服务。
public ref class DesignerActionService : IDisposable
public class DesignerActionService : IDisposable
type DesignerActionService = class
interface IDisposable
Public Class DesignerActionService
Implements IDisposable
- 继承
-
DesignerActionService
- 派生
- 实现
注解
类 DesignerActionService 负责管理设计时窗体上存在的组件的每个实例的对象集合 DesignerActionItem 。 此类支持项创建的直接推送模型,并且主要供设计时工具开发人员使用,尽管也可以由组件和自定义控件开发人员使用。
设计时工具开发人员需要确定要为组件显示的项列表,并确定此列表何时更改。 他们还可以创建与智能标记面板对象一起运行的加载项。
高级组件开发人员可能需要动态控制与组件关联的项,从而替换或补充标准拉取模型。 例如,可以根据面板命令的使用上下文和组件的设计时状态来更改面板命令。
注意
DesignerActionService实际上是推送和拉取模型背后的驾驶服务;但在后一种情况下,它隐式运行。
DesignerActionService 提供了一个用于访问和操作每个组件的项的简单界面,包括以下方法和事件:
方法 Contains 确定 当前是否 DesignerActionService 正在管理特定组件。
方法 GetComponentActions 支持项列表的枚举。
方法Add允许将 或 DesignerActionListCollection 添加到DesignerActionList组件实例的现有项集。 相反, Remove 方法删除与组件关联的一个或所有项列表。
注意
Add方法表示将面板项与组件关联的直接推送模型。 相比之下,拉取模型依赖于重写 ActionLists 该组件的设计器类的 属性。 在设计图面上创建组件时,设计环境负责将这些项添加到当前 DesignerActionService 中。
事件 DesignerActionListsChanged 指示组件的项集合何时更改。
由于通常需要在组件的设计时快捷菜单及其面板中使用一些相同的面板项,因此对象和设计器谓词之间存在 DesignerActionItem 很大程度的互操作性。
如果组件设计器未显式指定 DesignerActionList (,即它不包含) 重写 ActionLists 的属性,则将从现有设计器谓词创建一个列表。 这些谓词由 Verbs 属性指定。 在这种情况下,内部谓词列表类用于包含谓词项面板条目的集合。
如果希望 DesignerActionMethodItem 同时用作面板项和设计时快捷菜单项,则可以在项的构造函数中设置 includeAsDesignerVerb
参数。
DesignerActionUIService使用 来控制设计器的 的ActionLists显示。
构造函数
DesignerActionService(IServiceProvider) |
初始化 DesignerActionService 类的新实例。 |
方法
事件
DesignerActionListsChanged |
为任何组件移除或添加 DesignerActionList 时发生。 |