Eclipse界面编写实例(1)--扩展TitleAreaDialog

    TitleAreaDialog是Eclipse的Jface组件包中提供的一个对话框，它提供了一个可以显示标题、提示信息以及一个图标的区域，以及一个包含实际内容的区域，并默认提供了两个按钮。最显著的例子就是新建向导和导入导出的向导（这两个粒子都是扩展的Wizard，但对话框本身扩展的WizardDialog，而后者正是从TitleAreaDialog扩展而来）。本文档详细介绍如何从TitleAreaDialog创建自己的对话框。本例实现了如图所示的界面：

    按照常规方式创建工程，并准备资源文件。其中钥匙图标文件是icons/loginkey.gif。本例创建的对话框是WorkListLoginDialog。具体实现可以参考ChooseWorkspaceDialog，本文件实现了在Eclipse启动时工作区的选择功能。

    默认的，需要重写createDialogArea。本方法创建了OK和Cancel按钮上方的内容。一下代码是本例实现的代码，添加了详细的注释：

protected Control createDialogArea(Composite parent) {

    //获取产品名称，可以参考本段代码

    String productName = null;

    IProduct product = Platform.getProduct();

    if (product != null) {

       productName = product.getName();//productName就是产品名称了

    }

    if (productName == null) {

        productName=WorkListPlugin.getResourceString(

"esip.defaultProductName");

    }

    Composite composite = (Composite)

super.createDialogArea(parent);

//设置图标，注意我们采用AbstractUIPlugin.imageDescriptorFromPlugin

//从插件的icons目录中加载，不能直接使用ImageDescriptor. CreateFromFile()

//它需要绝对路径。而前者通过建立正确的路径，最终调用了//ImageDescriptor.createFromURL()

setTitleImage(AbstractUIPlugin.imageDescriptorFromPlugin(       WorkListPlugin.getDefault().getPluginId(),

"icons/loginkey.gif").createImage());

    //设置标题

setTitle(WorkListPlugin

                .getResourceString("dialog.title")); 

//设置提示信息

setMessage(MessageFormat.format(WorkListPlugin

.getResourceString(

"dialog.message"), new Object[] { productName }));

    //自定义要创建的内容

    createContentPane(composite);

    createLoginControls();

    return composite;

}  

其中自定义createContentPane创建了一个Composite用于摆放登录标签和输入框，createLoginControls创建了“用户名”“密码”标签和相应的输入框。如下：

private void createContentPane(Composite parent){

contentPane= new Composite(parent,SWT.NULL);

//采用三列的GridLayout

GridLayout layout=new GridLayout(3,false);

//以下数值通过实验调整得出，这样看起来能够使输入框在中间位置，比较美观

layout.marginHeight = 20;

layout.marginWidth = 70;

layout.verticalSpacing = 10;

layout.horizontalSpacing=10;

contentPane.setLayout(layout);

//注意充满FILL_BOTH

ContentPane.setLayoutData(new GridData(GridData.FILL_BOTH));

contentPane.setFont(parent.getFont());

}

private void createLoginControls(){

//Label user     

Label user= new Label(contentPane,SWT.NULL);

//右对齐

    GridData layoutData=new GridData(GridData.HORIZONTAL_ALIGN_END);

    user.setLayoutData(layoutData);

user.setText(WorkListPlugin

.getResourceString("dialog.login.user"));

//设置提示信息

    user.setToolTipText(WorkListPlugin.getResourceString("dialog.login

.userTooltip"));

//Text user

    Text userText= new Text(contentPane,SWT.BORDER | SWT.LEAD);

//横向扩充

    layoutData= new GridData(GridData.GRAB_HORIZONTAL

              | GridData.FILL_HORIZONTAL);

    // horizontalSpan=2 是让输入框占两个格的位置。这样看起来比较美观

    layoutData.horizontalSpan=2;

    userText.setLayoutData(layoutData);

    userText.setToolTipText(WorkListPlugin.getResourceString("dialog.

login.userTooltip"));

    //Label password

    Label password= new Label(contentPane,SWT.NULL);

    layoutData= new GridData(GridData.HORIZONTAL_ALIGN_END);

    password.setLayoutData(layoutData);

       password.setText(WorkListPlugin.getResourceString("dialog.login.password"));

    password.setToolTipText(WorkListPlugin.getResourceString("dialog.

login.passwordTooltip"));

    //Text password

    Text passwordText= new Text(contentPane,SWT.BORDER | SWT.LEAD);

    layoutData= new GridData(GridData.GRAB_HORIZONTAL

              | GridData.FILL_HORIZONTAL);

    layoutData.horizontalSpan=2;

    passwordText.setLayoutData(layoutData);

    passwordText.setEchoChar('*');

    passwordText.setToolTipText(WorkListPlugin.getResourceString(

"dialog.login.passwordTooltip"));

    }

另外可以重写configureShell，使之正确显示对话框标题栏：

    protected void configureShell(Shell newShell) {

       super.configureShell(newShell);

     newShell.setText(WorkListPlugin.getResourceString("dialog.name"));

    }

然后，重新okPressed和cancelPressed，实现当点击OK或Cancel按钮时处理事件。

    这样，我们便得到了上如所示的界面。

    可见，Eclipse的Jface包为我们提供了大量的可用的对话框，比如MessageDialog类就提供了openError,openConfirm,openInformation,openQuestion,openWarning等对话框。灵活应用这些接口和函数，可以是我们的界面编写方便又迅速。

    本例没有实现messageLabel对信息的响应。其实根据需要加入事件监听器，通过setMessage就可以实现。

    小结：扩展 TitleAreaDialog ，需要重写 createDialogArea 以实现自定义界面。另外重写按钮事件进行处理。