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以实现自定义界面。另外重写按钮事件进行处理。
