SharpDevelop插件开发手册部分内容摘取自:http://www.cnblogs.com/CBuilder的SharpDevelop开发教程
 

SharpDevelop插件开发手册

 

        Pad(面板)就是插件框架中的停靠窗口。有这些特点:Pad不能关闭,但可以隐藏或显示。每种类型的Pad只能打开一个,不能在运行时添加,标题唯一。可以显示图标,由插件框架中的布局管理器负责管理。通常不显示文件内容,而是辅助用户完成任务。

下面进入我们的实战流程,先新建一个类库型的项目,命名为CSPadDemoPlug,把Class1.cs改名为Main.cs,修改为如下内容:

 

 1SharpDevelop插件开发手册using System; 
 2SharpDevelop插件开发手册using System.Drawing; 
 3SharpDevelop插件开发手册using System.Windows.Forms; 
 4SharpDevelop插件开发手册 
 5SharpDevelop插件开发手册using ICSharpCode.SharpDevelop.Gui; 
 6SharpDevelop插件开发手册 
 7SharpDevelop插件开发手册namespace PadDemoPlug 
 8

 

记得要在项目中加入插件框架中的ICSharpCode.Core.dll和SharpDevelop.Base.dll引用。这两个文件在插件框架下的Bin目录下。写插件框架的插件需要包含。

       在项目中添加新建项à用户控件。改名为CSPadControl。各位可以在CSPadControl上添加一些相关的内容。

       在工程中添加一个DemoPlug.addin文件,这是插件配置文件,很重要,内容如下:

 

 1SharpDevelop插件开发手册<AddIn name        = "SharpDevelop Plug Demo" 
 2SharpDevelop插件开发手册       author      = "SongYuanWu" 
 3SharpDevelop插件开发手册       copyright   = "GPL" 
 4SharpDevelop插件开发手册       url         = "http://www.cnblogs.com/CBuilder" 
 5SharpDevelop插件开发手册       description = "SharpDevelop " 
 6SharpDevelop插件开发手册       version     = "1.0.0"> 
 7SharpDevelop插件开发手册     
 8SharpDevelop插件开发手册    <Runtime> 
 9SharpDevelop插件开发手册        <Import assembly="PadDemo.dll"/> 
10SharpDevelop插件开发手册    </Runtime> 
11SharpDevelop插件开发手册 
12SharpDevelop插件开发手册    <Extension path = "/SharpDevelop/Workbench/Views"> 
13SharpDevelop插件开发手册        <Class id    = "PadDemo"  
14SharpDevelop插件开发手册              class = "PadDemoPlug.Pad"/> 
15SharpDevelop插件开发手册    </Extension> 
16SharpDevelop插件开发手册</AddIn>  
17SharpDevelop插件开发手册 
18SharpDevelop插件开发手册

 

       OK!把编译后的PadDemo.dll和DemoPlug.addin文件拷贝到的/AddIns/目录下,运行插件框架就可以看到我们创建的Pad了(如下图),同时在插件框架的菜单【查看】-【工具】下也出现了TestPanel菜单项。

 

如果需要指定pad的图标时,可以改更改base("TestPanel")为 base("TestPanel", "IconID")。

 InconID为图标的资源号,作为演示你可以用Class的图标“Icons.16x16.Class”来替代。

要点分析:

        制作Pad的时候要从AbstractPadContent继承。所以要using ICSharpCode.SharpDevelop.Gui;  

第二章    工作区

第一节 创建工区作

View(工作区)是SD的基础部分,View通常包含编辑器,如代码编辑器,资源编辑器。基本上,它是显示于MPI窗口选项卡页面上的面板。

     制作View要从AbstractViewContent继承下来。下面就进入我们的实战操作流程,首先新建一个类库行的项目,SDViewDemoPlug,把Class1.cs改名为Main.cs,修改为如下内容:

  

 1SharpDevelop插件开发手册 using System;
 2SharpDevelop插件开发手册 using ICSharpCode.Core.AddIns;
 3SharpDevelop插件开发手册 using ICSharpCode.Core.AddIns.Codons;
 4SharpDevelop插件开发手册 
 5SharpDevelop插件开发手册 using ICSharpCode.SharpDevelop.Gui;
 6SharpDevelop插件开发手册 
 7SharpDevelop插件开发手册 namespace SDViewDemoPlug
 8

 

添加一个新类,SDViewContent,文件名为SDViewContent.cs,修改内容如下:

 1SharpDevelop插件开发手册using System;
 2SharpDevelop插件开发手册using System.Drawing;
 3SharpDevelop插件开发手册using System.Windows.Forms;
 4SharpDevelop插件开发手册using ICSharpCode.SharpDevelop.Gui;
 5SharpDevelop插件开发手册
 6SharpDevelop插件开发手册namespace SDViewDemoPlug
 7

 

在项目中添加新建项用户控件。改名为SDViewControl。各位可以在SDViewControl上添加一些相关的内容。最后添加插件配置文件ViewDemoPlug.addin,内容如下:

 1SharpDevelop插件开发手册<AddIn name        = "SharpDevelop Plug Demo"
 2SharpDevelop插件开发手册       author      = "SongYuanWu"
 3SharpDevelop插件开发手册       copyright   = "GPL"
 4SharpDevelop插件开发手册       url         = "http://www.cnblogs.com/CBuilder"
 5SharpDevelop插件开发手册       description = "SharpDevelop"
 6SharpDevelop插件开发手册       version     = "1.0.0">
 7SharpDevelop插件开发手册    
 8SharpDevelop插件开发手册    <Runtime>
 9SharpDevelop插件开发手册        <Import assembly="SDViewDemoPlug.dll"/>
10SharpDevelop插件开发手册    </Runtime>
11SharpDevelop插件开发手册
12SharpDevelop插件开发手册    <Extension path = "/SharpDevelop/Workbench/MainMenu/Tools">
13SharpDevelop插件开发手册        <MenuItem id = "SDViewDemo"                 
14SharpDevelop插件开发手册                 label = "ShowMyView" 
15SharpDevelop插件开发手册                 class = "SDViewDemoPlug.ShowViewCommand"/>
16SharpDevelop插件开发手册    </Extension>
17SharpDevelop插件开发手册</AddIn>
18SharpDevelop插件开发手册

 

还有不要忘记把ICSharpCode.Core.dll和SharpDevelop.Base.dll引用进项目中来。编译后把ViewDemoPlug.addin和SDViewDemoPlug.dll拷贝到SD的/AddIns/目录下。运行SD,就可以看到在【工具】菜单下出现了【ShowMyView】菜单项。Click【ShowMyView】菜单项后显示如图,再click【ShowMyView】菜单项后就会又显示一个TestView。各位如果问:“需要做象“启动页”一样的View,如果已经有打开的了就会激活打开的View该如何处理呢?”。其实很简单,你可以把ShowViewCommand类中的Run函数更改为:

 

 1SharpDevelop插件开发手册foreach (IViewContent view in WorkbenchSingleton.Workbench.ViewContentCollection) 
 2

 

此Demo演示了如何在SD添加一个View,同时也演示了如何在SD中更改菜单项。每添加一个菜单项时都要继承一个AbstractMenuCommand,并且改写Run()函数,当然你的XXXCommand也可以从SD的AbstractCommand继承,但要实现IMenuCommand接口。因为添加菜单项和添加工具条按钮比较简单,在以后的内容中我会一起讲,在此我就不多说了。

 

第二节 工作区关闭控制

   插件框架的工作区(AbstractViewContent)和主窗体(WorkbenchSingleton.MainForm)在是否关闭可能通过窗体的Closing事件来进行控制,和普通窗体关闭事件没有太大区别。

    MainForm和常用的窗体没有什么区别,这里就不做特殊说明。 

    由于工作区本身不是一窗体,所以它没有Closing事件,但是它本身是有父窗体(AbstractViewContent.WorkbenchWindow)的,我们完全可以通过它父窗体的Closing事件来进行控制,示例如下

 1SharpDevelop插件开发手册namespace EtsWorkFlow.Designer.ViewContent
 2


第三章   配置文件

一、菜单配置

1SharpDevelop插件开发手册<MenuItem id = "TipOfTheDay"
2SharpDevelop插件开发手册          label = "${res:XML.MainMenu.HelpMenu.Tips}"
3SharpDevelop插件开发手册          icon = "Icons.16x16.TipOfTheDay"
4SharpDevelop插件开发手册      shortcut = "Shift|Control|F1"
5SharpDevelop插件开发手册          insertafter = "Separator2"
6SharpDevelop插件开发手册          class = "ICSharpCode.SharpDevelop.Commands.ViewTipOfTheDay" />
7SharpDevelop插件开发手册<MenuItem id = "Downloads" label = "Downloads(&amp;D)" icon = "Icons.16x16.WebSearchIcon" link = "http://www.sharpdevelop.net/OpenSource/SD/Download/" />
8SharpDevelop插件开发手册

1)id:代表唯一标识

2)label:是菜单的标题,它即可以从资源文件中读取,也可以直接进行设置,如果要设置热键,格式如下:(&字母)

3)icon:表示,菜单的图标,该图标在resource格式的文件中定义

4)shortcut:设置快捷键

5)link:这里就是当前菜单项要链接的网址,也可以链接外部文件,示例如下:link = "home://doc/ReadMe.rtf",表示主程序上级的doc目录下的ReadMe.rtf文件。

6)class:表示该菜单对应的命令。

7)insertafter:表示插在哪个菜单项之后

 

如果要建立子菜单只需要添加MenuItem子节点即可,格式如下:

1SharpDevelop插件开发手册   <MenuItem id = "Help" label = "${res:XML.MainMenu.HelpMenu}" type="Menu">
2SharpDevelop插件开发手册      <MenuItem id = "Separator2" type = "Separator" />
3SharpDevelop插件开发手册      <MenuItem id = "delphidoc"  label = "公司主页" icon = "Icons.16x16.WebSearchIcon" link = "http://www.cnblogs.com/delphidoc" />
4SharpDevelop插件开发手册    </MenuItem>
5SharpDevelop插件开发手册

 

二、MenuItem类型

 

MenuItem共有四种类型

1) type = "Menu"         普通父菜单

2) type = "Separator"      分隔符

3) type = "Item"      菜单项

4) type = "Builder"        由代码购建的菜单,如文件历史列表

 

三、状态控制

插件框架中生成的工具栏按钮和菜单项都可以通过配置文件来进行控制。

示例如下:

 1SharpDevelop插件开发手册  <Runtime>
 2SharpDevelop插件开发手册      <Import assembly="EtsWorkFlow.Designer.dll">
 3SharpDevelop插件开发手册        <ConditionEvaluator name="ActiveViewContent" class="EtsWorkFlow.Designer.Command.ActiveViewContentConditionEvaluator"/>
 4SharpDevelop插件开发手册      </Import>
 5SharpDevelop插件开发手册    </Runtime>
 6SharpDevelop插件开发手册
 7SharpDevelop插件开发手册    <Condition name = "ActiveViewContent" action="Disable">
 8SharpDevelop插件开发手册      <MenuItem id = "SaveFlowFile"
 9SharpDevelop插件开发手册                 label = "保存(&amp;S)" 
10SharpDevelop插件开发手册                 icon  = "Icons.16x16.SaveIcon"
11SharpDevelop插件开发手册                 shortcut = "Control|S"
12SharpDevelop插件开发手册                 class = "EtsWorkFlow.Designer.Command.SaveCommand"/>
13SharpDevelop插件开发手册    </Condition>
14SharpDevelop插件开发手册

 

配置的关键字为:Condition ,它含两个属性(name 和action),name 的名称对应 runtime中定义的ConditionEvaluator的name,它和程序中从IConditionEvaluator接口继承的状态控制类形成对应关系

1SharpDevelop插件开发手册    public class ActiveViewContentConditionEvaluator : IConditionEvaluator
2

 

     IConditionEvaluator接口非常简单,只有一个IsValid方法。

配置文件中的条件在“IsValid”返回false时执行,执行结果由来action决定。

action共有3种状态:

1

Nothing:表示什么都不做

Execlude:表示一笔移除

Disable:表示改变状态为不可用

 

默认为:Execlude

相关文章:

  • 2021-12-23
  • 2019-10-24
  • 2021-11-30
  • 2021-11-17
  • 2021-11-20
  • 2021-11-09
  • 2021-08-06
  • 2021-10-17
猜你喜欢
  • 2021-11-23
  • 2021-12-24
  • 2021-09-29
  • 2021-11-23
  • 2021-10-18
  • 2021-09-22
  • 2021-12-02
  • 2021-11-13
相关资源
相似解决方案