使用Eclipse RCP进行桌面程序开发（四）：在Windows中使用Active X控件

╰+攻爆jí腚メ 2022-08-13 16:43 15阅读 0赞

看完这篇文章，可以开发如下的界面：  
  
没有嵌入Active X控件的视图：  
![rcp29.JPG][]  
  
嵌入浏览器控件，并显示 [www.blogjava.net][] 的主页：  
![rcp30.JPG][]  
  
在Windows系统下，OLE和Active X控件是两个非常吸引人的技术，它们的基础都是COM。OLE的体验，就是平时我们可以把Excel表格嵌入Word文档，或者把PDF嵌入浏览器显示一样，而Active X控件更是无处不在，做VB开发和网页开发的人都应该很熟悉。使用Windows系统中丰富的Active X控件资源，我们可以实现功能非常强大的程序。  
  
在Windows平台下，SWT图形工具包提供了对OLE的支持，Active X控件和OLE文档都可以被很方便地嵌入SWT窗口部件或者JFace部件，在这里，我只讨论将Active X控件插入视图。  
  
在一个视图中包含一个Active X控件需要两个对象的支持，即一个OleFrame和一个OleClientSite对象。如果需要创建一个OLE应用，需要先后创建他们。创建OleFrame对象比较简单，OleFrame类定义在org.eclipse.swt.ole.win32中，创建OleFrame对象只需要简单的new就可以，如下：

1 ![None.gif][]OleFrame frame =  new OleFrame(parent, SWT.NONE);

在这个构造函数中，第一个参数指的是该OleFrame的母窗口部件，即Active X控件将要被嵌入的窗口部件。  
  
在OleFrame的基础上就可以创建OleClientSite对象，创建该对象需要知道控件的programID，这个ID的信息存放在windows的注册表中。在我们这篇文章的例子中，我们使用的是一个浏览器控件，那么我们怎么知道浏览器控件的ProgID呢？我使用的是Visual Studio 2003自带的OleView工具，如下图：  
![rcp26.JPG][]  
  
可以看到，Microsoft Web 浏览器的ProgID为Shell.Explorer.2，我们可以这样创建OleClientSite对象：

1 ![None.gif][]OleClientSite client =  new OleClientSite(frame,SWT.NONE,"Shell.Explorer.2");

创建对象后，还需要激活，才能够在RCP程序中对这些OLE对象进行操作。如下：

![None.gif][]client.doVerb(OLE.OLEIVERB\_SHOW);

然后，我们需要操作这个Active X控件，调用它的方法，或者设置它的属性。比如在此例中，我们需要调用浏览器控件的navigate方法，以便我们的浏览器控件显示 [www.blogjava.net][] 的主页。对Active X控件的操作通过OleAutomation对象来实现，创建OleAutomation对象的方法如下：

![None.gif][]OleAutomation automation =  new OleAutomation(client);

再通过automation.invoke()来调用Active X控件的方法，其中invoke方法有几种重载形式，有只带一个int参数的，也有带int和Variant\[\]两个参数的，其中的int参数表示要调用的Active X控件的方法的ID，Variant\[\]参数就是要传递给Active X控件的方法的参数。  
  
这里我们要说一说Variant类，这个类提供了多个构造函数，可以方便的将int,float,long,double,string等等基本数据类型封装为Variant，比如我们要传递给浏览器控件的navigate方法的地址参数：

![None.gif][]Variant url =  new Variant("http://www.blogjava.net");

那么我们怎么才能得到Active X控件的方法的ID，还有它需要哪些参数呢？还是要借助前面提到的OleView.exe工具，如下图：  
![rcp27.JPG][]  
  
![rcp28.JPG][]  
  
可以看到，Navigate方法的id为0x00000068，转化为十进制就是104，而它需要的参数第一个是一个字符串，其它的都是可选的，因此，我们可以这样调用它的方法：

![None.gif][]Variant url =  new Variant("http://www.blogjava.net/");  
![ExpandedBlockStart.gif][]automation.invoke(104,  new Variant\[\] \{url\});

下面，贴出本文例子中的视图的代码和菜单Action的代码，在写这篇文章之前，我一直在探索怎样从菜单控制视图，后来发现是这样：  
 window.getActivePage.getViewReferences();  
虽然我不知道Eclipse中Page的概念究竟是什么，但是只要能找到我要操作的视图就可以了。视图的代码如下：  
  
OleView.java

1 ![None.gif][] package cn.blogjava.youxia.views;  
 2 ![None.gif][]  
 3 ![None.gif][] import org.eclipse.jface.action.IMenuManager;  
 4 ![None.gif][] import org.eclipse.jface.action.IToolBarManager;  
 5 ![None.gif][] import org.eclipse.swt.SWT;  
 6 ![None.gif][] import org.eclipse.swt.widgets.Composite;  
 7 ![None.gif][] import org.eclipse.ui.part.ViewPart;  
 8 ![None.gif][] import org.eclipse.swt.ole.win32.OleFrame;  
 9 ![None.gif][]  
10 ![ExpandedBlockStart.gif][] public  class OleView  extends ViewPart  \{  
11![InBlock.gif][]    public OleFrame frame;  
12![InBlock.gif][]  
13![InBlock.gif][]    public static final String ID = "cn.blogjava.youxia.views.OleView"; //$NON-NLS-1$  
14![InBlock.gif][]  
15![ExpandedSubBlockStart.gif][]    /\*\*  
16![InBlock.gif][]     \* Create contents of the view part  
17![InBlock.gif][]     \* @param parent  
18![ExpandedSubBlockEnd.gif][]     \*/  
19![InBlock.gif][]    @Override  
20![ExpandedSubBlockStart.gif][]    public void createPartControl(Composite parent) \{  
21![InBlock.gif][]        frame = new OleFrame(parent, SWT.NONE);  
22![InBlock.gif][]          
23![InBlock.gif][]        //  
24![InBlock.gif][]        createActions();  
25![InBlock.gif][]        initializeToolBar();  
26![InBlock.gif][]        initializeMenu();  
27![ExpandedSubBlockEnd.gif][]    \}  
28![InBlock.gif][]  
29![ExpandedSubBlockStart.gif][]    /\*\*  
30![InBlock.gif][]     \* Create the actions  
31![ExpandedSubBlockEnd.gif][]     \*/  
32![ExpandedSubBlockStart.gif][]    private void createActions() \{  
33![InBlock.gif][]        // Create the actions  
34![ExpandedSubBlockEnd.gif][]    \}  
35![InBlock.gif][]  
36![ExpandedSubBlockStart.gif][]    /\*\*  
37![InBlock.gif][]     \* Initialize the toolbar  
38![ExpandedSubBlockEnd.gif][]     \*/  
39![ExpandedSubBlockStart.gif][]    private void initializeToolBar() \{  
40![InBlock.gif][]        IToolBarManager toolbarManager = getViewSite().getActionBars()  
41![InBlock.gif][]                .getToolBarManager();  
42![ExpandedSubBlockEnd.gif][]    \}  
43![InBlock.gif][]  
44![ExpandedSubBlockStart.gif][]    /\*\*  
45![InBlock.gif][]     \* Initialize the menu  
46![ExpandedSubBlockEnd.gif][]     \*/  
47![ExpandedSubBlockStart.gif][]    private void initializeMenu() \{  
48![InBlock.gif][]        IMenuManager menuManager = getViewSite().getActionBars()  
49![InBlock.gif][]                .getMenuManager();  
50![ExpandedSubBlockEnd.gif][]    \}  
51![InBlock.gif][]  
52![InBlock.gif][]    @Override  
53![ExpandedSubBlockStart.gif][]    public void setFocus() \{  
54![InBlock.gif][]        // Set the focus  
55![ExpandedSubBlockEnd.gif][]    \}  
56![InBlock.gif][]  
57![ExpandedBlockEnd.gif][]\}  
58 ![None.gif][]

在这个视图中，我创建了OleFrame对象，并让它是public的，至于OleClientSite和OleAutomation对象，我们在点击菜单项后创建。菜单动作的代码如下：  
  
OpenFileAction.java

1 ![None.gif][] package cn.blogjava.youxia.actions;  
 2 ![None.gif][]  
 3 ![None.gif][]  
 4 ![None.gif][] import org.eclipse.jface.action.IAction;  
 5 ![None.gif][] import org.eclipse.jface.viewers.ISelection;  
 6 ![None.gif][] import org.eclipse.swt.SWT;  
 7 ![None.gif][] import org.eclipse.swt.ole.win32.OLE;  
 8 ![None.gif][] import org.eclipse.swt.ole.win32.OleClientSite;  
 9 ![None.gif][] import org.eclipse.ui.IWorkbenchWindow;  
10 ![None.gif][] import org.eclipse.ui.IWorkbenchWindowActionDelegate;  
11 ![None.gif][] import org.eclipse.ui.\*;  
12 ![None.gif][] import cn.blogjava.youxia.views.\*;  
13 ![None.gif][] import org.eclipse.swt.ole.win32.OleAutomation;  
14 ![None.gif][] import org.eclipse.swt.ole.win32.Variant;  
15 ![None.gif][]  
16 ![ExpandedBlockStart.gif][] public  class OpenFileAction  implements IWorkbenchWindowActionDelegate  \{  
17![InBlock.gif][]  
18![InBlock.gif][]    IWorkbenchWindow window;  
19![InBlock.gif][]      
20![ExpandedSubBlockStart.gif][]    public void dispose() \{  
21![InBlock.gif][]        // TODO 自动生成方法存根  
22![InBlock.gif][]  
23![ExpandedSubBlockEnd.gif][]    \}  
24![InBlock.gif][]  
25![ExpandedSubBlockStart.gif][]    public void init(IWorkbenchWindow window) \{  
26![InBlock.gif][]        // TODO 自动生成方法存根  
27![InBlock.gif][]        this.window = window;  
28![InBlock.gif][]  
29![ExpandedSubBlockEnd.gif][]    \}  
30![InBlock.gif][]  
31![ExpandedSubBlockStart.gif][]    public void run(IAction action) \{  
32![InBlock.gif][]        // TODO 自动生成方法存根  
33![InBlock.gif][]          
34![InBlock.gif][]        IViewReference\[\] vfs = window.getActivePage().getViewReferences();  
35![InBlock.gif][]        IViewPart vw;  
36![ExpandedSubBlockStart.gif][]        for(int i=0; i<vfs.length; i++)\{  
37![InBlock.gif][]             vw = vfs\[i\].getView(false);  
38![ExpandedSubBlockStart.gif][]             if(vw.getTitle().equals("使用Active X控件"))\{  
39![InBlock.gif][]                    OleClientSite client = new OleClientSite(((OleView)vw).frame,SWT.NONE,"Shell.Explorer.2");  
40![InBlock.gif][]                    client.doVerb(OLE.OLEIVERB\_SHOW);  
41![InBlock.gif][]                    OleAutomation oa = new OleAutomation(client);  
42![InBlock.gif][]                    Variant str = new Variant("http://www.blogjava.net/");  
43![ExpandedSubBlockStart.gif][]                    oa.invoke(104, new Variant\[\]\{str\});  
44![InBlock.gif][]          
45![ExpandedSubBlockEnd.gif][]             \}  
46![ExpandedSubBlockEnd.gif][]        \}  
47![InBlock.gif][]          
48![ExpandedSubBlockEnd.gif][]    \}  
49![InBlock.gif][]  
50![ExpandedSubBlockStart.gif][]    public void selectionChanged(IAction action, ISelection selection) \{  
51![InBlock.gif][]        // TODO 自动生成方法存根  
52![InBlock.gif][]  
53![ExpandedSubBlockEnd.gif][]    \}  
54![InBlock.gif][]  
55![ExpandedBlockEnd.gif][]\}  
56 ![None.gif][]

根据前面几节将的内容配置plugin.xml和修改Perspective.java的代码，就可以看到文章开头的效果了。

[rcp29.JPG]: /images/20220810/9c697bdf98954213a0085c5b3b5bafff.png
[www.blogjava.net]: http://www.blogjava.net/youxia/archive/2006/11/28/84013.html
[rcp30.JPG]: /images/20220810/57f85ecf0b7c494981d645c9026a9d52.png
[None.gif]: /images/20220810/2c1b57d679b1453f8080ef9bf5d6f875.png
[rcp26.JPG]: /images/20220810/40941e7b44f349e2aa3d8e7838c366b8.png
[rcp27.JPG]: /images/20220810/e217977b7a154cdabe6b4e6ee2ea5983.png
[rcp28.JPG]: /images/20220810/e52e60fa56334a73ab6fa2f90c4d1c3e.png
[ExpandedBlockStart.gif]: /images/20220810/a35db977cc6545dbadacbea08f8967c0.png
[InBlock.gif]: /images/20220810/4043f7a0d1aa424cb66b6d00a50632ee.png
[ExpandedSubBlockStart.gif]: /images/20220810/718e413b2d0f4ac6a260729907fa2763.png
[ExpandedSubBlockEnd.gif]: /images/20220810/ba82c0b173c04c34ae17d15d882ff528.png
[ExpandedBlockEnd.gif]: /images/20220810/3dc719b8f1d347ee82a54bcf4f78d263.png