eclipse3.5 实现RCP帮助

RCP的帮助系统，分以下几步。

1.首先要添加对应的菜单项

      在类中加入帮助菜单项。

      (1).为ApplicationActionBarAdvisor类添加成员变量

            private IWorkbenchAction helpAction;

      (2).在makeActions方法中注册帮助操作。

protected void makeActions(IWorkbenchWindow window) {

      ….

           helpAction = ActionFactory.HELP_CONTENTS.create(window);

          register(helpAction);

      ….

}

(3).在fillMenuBar方法中添加帮助菜单

protected void fillMenuBar(IMenuManager menuBar) {

      ….

      final MenuManager menuManager_5 = new MenuManager("帮助(&W)");

      menuBar.add(menuManager_5);

      menuManager_5.add(helpAction);

      ….

}

 

2. 添加相关的依赖性。
       打开plugin.xml，转到"依赖项"的tab页,点击"添加"按钮，需要加入下面的这些依赖项：

org.apache.lucene
org.eclipse.help.appserver
org.eclipse.help.base
org.eclipse.help.ui
org.eclipse.help.webapp
org.eclipse.equinox.http.jetty

org.eclipse.ui.forms

尤其注意;在eclipse3.4以后放弃使用org.eclipse.tomcat

 

3. 添加org.eclipse.help.toc扩展点

在plugin.xml的尾端添加（plugin标记中）

<extension

         point="org.eclipse.help.toc">

      <toc

            file="toc.xml"

            primary="true">

      </toc>

      <toc

            file="testToc.xml"

            primary="true">

      </toc>

 </extension>

添加成功后，在扩展tab页面中出现org.eclipse.help.toc扩展

 

 

4.在plugin.xml同一层次创建扩展点中定义的toc.xml与testToc.xml

      Toc.xml：

     

<?xml version="1.0" encoding="UTF-8"?>

<?NLS TYPE="org.eclipse.help.toc"?>

 

<toc label="Sample Table of Contents">

      <topic label="Main Topic"  href="html/maintopic.html">

           <topic label="Sub Topic" href="html/subtopic.html"/>

      </topic>

      <topic label="Main Topic 2"/>

</toc>

 

TestToc.xml：

<?xml version="1.0" encoding="UTF-8"?>

<?NLS TYPE="org.eclipse.help.toc"?>

 

<toc label="Test TOC" topic="html/toc.html">

      <link toc="toc.xml" />

</toc>

 

      5.以plugin.xml所在目录为当前目录创建xml文件中定义的html文件，此例中为HTML文件夹下创建maintopic.html、subtopic.html、toc.html。

 

      然后，按照自己的帮助内容书写html文件。

 

      帮助界面：