RCP II：扩展通用工作台(5)

5、定义动作

（1）动作概述

l         在 Eclipse 工作台中，动作是应用程序用户触发的命令

l         一般，动作可分为三种不同的类型：按钮、工具条项和菜单项

l         当在工作台内执行动作时，动作的run方法在应用程序中执行其特定功能

l         除了动作类外，动作还可以具有其他属性用于在工作台内控制动作的呈现方式，这些属性包括文本标签、工具提示信息和图标

l         本教程的Google应用程序中有两个动作：一个用于退出应用程序（菜单项动作），另一个允许用户通过点击Search视图中的License Key按钮（按钮动作）来激活License Key向导

（2）定义org.eclipse.ui.viewActions扩展

   <extension

         point="org.eclipse.ui.viewActions">

      <viewContribution

            targetID="com.xqtu.google.views.SearchView"

            id="com.xqtu.google.views.contribution">

         <action

               toolbarPath="additions"

               label="License Key"

               tooltip="Google License Key"

               class="com.xqtu.google.actions.LicenseKeyAction"

               style="push"

               state="false"

               id="com.xqtu.google.actions.LicenseKeyAction"/>

      </viewContribution>

   </extension>

l         在视图中的动作，需要在plugin中定义org.eclipse.ui.viewActions扩展

l         <viewContribution>定义特定视图的一组菜单和动作；id属性是其唯一标识；targetID属性指定特定视图的id

l         <action>定义动作的属性和动作类，主要包括：

Ø         toolbarPath：目标视图工具条中的一个命名组，缺省是additions；类似的menubarPath属性对应于下拉菜单

Ø         label：动作的标签

Ø         tooltip：动作的工具提示文本

Ø         class：实现org.eclipse.ui.IviewActionDelegate接口（视图动作代理）的类的全路径

Ø         style：动作的风格，可以是push、radio或toggle

Ø         state：当动作的风格是toggle，指定动作的初始状态

Ø         id：动作的唯一标识

（3）创建LicenseKeyAction类

package com.xqtu.google.actions;

import org.eclipse.jface.action.IAction;

import org.eclipse.jface.viewers.ISelection;

import org.eclipse.jface.wizard.WizardDialog;

import org.eclipse.ui.IViewActionDelegate;

import org.eclipse.ui.IViewPart;

import com.xqtu.google.views.SearchView;

import com.xqtu.google.wizards.LicenseKeyWizard;

public class LicenseKeyAction implements IViewActionDelegate {

    private SearchView searchView;

    public void init(IViewPart view) {

        this.searchView = (SearchView) view;

    }

    public void run(IAction action) {

        LicenseKeyWizard wizard = new LicenseKeyWizard();

        WizardDialog dialog = new WizardDialog(searchView.getViewSite()

                .getShell(), wizard);

        dialog.open();

    }

    public void selectionChanged(IAction action, ISelection selection) {

    }

}

l         LicenseKeyAction动作类实现IviewActionDelegate接口；在init方法中保存目标视图对象；在run方法中通过WizardDialog激活并打开License Key向导