Java桌面技术

Java Desktop Technology

常用链接

统计

友情连接

最新评论

用SWT实现MSN风格的下拉框

SWT一个所谓的优点是它的本地化外观,因为它是通过JNI调用操作系统的组件,从而可以保证外观上适合大多数用户的需求,但是一些IM类软件商往往希望它们的产品有着一套独特的外观,这对SWT这种原生组件来说就有些力不从心了,严格来说如果你的用户对外观要求比较苛刻,那么Swing是首选,因为L&F机制可以确保你做到这一点,另外Swing还有着许多SWT不具备的优点,例如半透明组件、渲染等,但是少数的这些特性用SWT还是可以模拟的,本文就向大家介绍如何通过自定义组件实现MSN风格的下拉框。
  通常来说,SWT提供的组件集基本上能满足大多数用户的需求,而自定义组件通常分为2种,一种是将若干基本组件组合成一个复合组件(如日历组件);第二是对现有组件改善外观从而符合客户的要求;或者将这两种混合使用。利用SWT实现自定义组件通常要继承Composite或Canvas来实现,但是绝大多数采用继承Composite实现,如果你查看SWT的源代码,你会发现很多SWT高级组件(如ExpandBar)都是直接继承Composite来实现的。
  准备工作,首先将MSN登录界面的截图帖出来参考。
                
如果要模拟MSN的用户名输入组件,你需要采集一些数据,分别是:正常、禁用两种状态下边框的颜色;正常、禁用两种状态下的背景色;右边下拉按钮的图标。现在将这几组数据给出。
正常状态下边框的颜色:RGB 170,183,199
禁用状态下边框的颜色:RGB 208,215,229
正常状态下的背景色:RGB 254, 254, 254
禁用状态下的背景色:RGB 238, 241, 249
下拉按钮的图标:
接下来创建一个类叫做ComboSelector继承自Composite。需要指出的是,这个自定义组件SWT组件库支持,在Eclipse下如果有VE、swt-designer这样的插件可以借助向导将必要的库导入到工程的classpath下,此外如果部署SWT应用程序还需要一个动态库,关于如何部署本文不作阐述。
创建以上这些数据常量
private final Color ENABLED_LINE_COLOR = new Color(Display.getCurrent(), 170, 183, 199);

private final Color DISABLED_LINE_COLOR = new Color(Display.getCurrent(), 208, 215, 229);

private final Color ENABLED_BG = new Color(Display.getCurrent(), 254, 254, 254);

private final Color DISABLED_BG = new Color(Display.getCurrent(), 238, 241, 249);

private final Image COMBO_ICON = new Image(Display.getDefault(), "combo.png");

另外你还需要一个基本文本组件用于输入、一个菜单显示保存的数据。

private Text inputText;

private Menu selectorMenu;

以上这些是和显示相关的变量,但是除了这些还要保存临时的数据,分别是当前用户选择了的那一项、下拉框所有数据项的集合。为了实现通用性和移植性这两组数据均用Object保存。

private Object selectedItem;

private Vector dataSet = new Vector();

接着定义构造函数。

public ComboSelector(Composite parent) {...}

需要注意的是,与Swing组件不同,任何SWT组件的构造器一定要有一个不为null的指向其父组件的参数,也就是说,SWT组件一旦被创建,就和它的父组件绑定了,其父组件不会提供任何add(...)、remove(...)方法添加或者移除组件,除非子组件调用dispose()方法销毁自身。而Swing组件构造时无需指父组件,而是通过父组件调用add(Component comp)将组件加进来,从这一点来说,Swing复合JavaBean规范,这个优势是SWT所无法比拟的。

在完成构造函数之前,我们先定义一个辅助函数,用来获取该组件在屏幕中的坐标,其思想是循环调用getParent()方法获取父组件,直到为null为止,因为这样循环调用getParent()总会找到最外层的窗口Shell对象。然后将各个子组件在其父组件上的坐标依次相加。

方法如下:

private Point getScreemLocation() {
  Control control = this;
  int width = control.getLocation().x;
  int height = control.getLocation().y;
  while (control.getParent() != null) {
   control = control.getParent();
   width += control.getLocation().x;
   height += control.getLocation().y;
  }
  return new Point(width, height);
}

现在让我们完成构造函数

super(parent, SWT.FLAT);
inputText = new Text(this, SWT.FLAT);
selectorMenu = new Menu(this);
setMenu(selectorMenu);

首先实现父组件的构造器,注意,将风格设置为FLAT或者NONE。如果为BORDER,那么运行时会发现组件是凹陷下去的外观(WindowsXP以前就是这种外观),通常对于自定义的外观都需要将风格设置为SWT.FLAT或者SWT.NONE。然后创建基本文本、菜单。对于菜单需要注意的是除了在构造时候要指定父组外,还要调用setMenu将菜单加进来。

接下来一步很关键,是要进行自定义绘制。绘制包括边框和下拉按钮的图标。

完整代码如下:

addPaintListener(new PaintListener() {
   public void paintControl(PaintEvent e) {
    GC gc = e.gc;
    gc.setForeground(isEnabled() ? ENABLED_LINE_COLOR
      : DISABLED_LINE_COLOR);
    gc.drawRectangle(0, 0, getSize().x - 1, getSize().y - 1);
    gc.drawImage(COMBO_ICON, getSize().x
      - COMBO_ICON.getBounds().width - 5,
      (getSize().y - COMBO_ICON.getBounds().height) / 2);
   }
  });
首先根据组件是否可用决定边框的颜色。调用drawRectangle完成绘制边框的操作。

然后绘制图标,注意,drawImage后两个参数是绘制的坐标,也就是从哪里开始画起,模拟MSN用户名输入组件时,下拉按钮右端点x坐标取距离组件最右端x坐标(getSize().x)5像素处为最佳,因此计算得出下拉按钮左端点x坐标为getSize().x- COMBO_ICON.getBounds().width - 5。(左端点x坐标与右端点x坐标相差COMBO_ICON.getBounds().width应该很容易理解,另外读者对坐标系的概念应该有一定了解);对于按钮的y坐标,计算思想是使按钮的垂直位置居中,因此计算y坐标公式为(getSize().y - COMBO_ICON.getBounds().height) / 2)。

接下来一步是确定基本文本组件的位置,完整代码如下:

addControlListener(new ControlAdapter() {
   @Override
   public void controlResized(ControlEvent e) {
    inputText.setBounds(1, 1, getSize().x
      - COMBO_ICON.getBounds().width - 15, getSize().y - 2);
   }
  });
给该组件注册Control监听器时,当该组件尺寸发生变化,会触发controlResized方法,在该方法内对基本文本组件的位置进行调整。模拟MSN用户名输入组件原则是,基本文本组件的边框被隐藏(构造时候通过将Style设为SWT.FLAT),左端点x坐标为1(为0的话会遮挡边框线的左端),长度是整个组件长度减去下拉按钮的长度再减15像素为最佳,从而保证与下拉按钮之间有一段距离,高度是整个组件的高度减2像素,过高会遮挡边框线。

接着我们要重写setEnabled方法,代码如下:

public void setEnabled(boolean enabled) {
  super.setEnabled(enabled);
  setBackground(enabled ? ENABLED_BG : DISABLED_BG);
  inputText.setEnabled(enabled);
  redraw();
 }

第一行的super.setEnabled(enabled);表示保持父类enable属性不变化,之后是设置背景,并设置inputText的enabled属性,最后调用redraw方法通知组件重绘。需要阐明的是,redraw方法会调用PaintListener中的方法,也就是说会调用到构造函数中public void paintControl(PaintEvent e){...}这段代码,如果组件添加了多个绘制监听器,那么redraw会依次调用每个监听器的paintControl方法,这与swing的事件机制是相同的。在redraw方法中根据isEnabled()的值决定边框的颜色,所以每当setEnable方法被调用都应该执行重绘。

还需要指出,通过添加绘制监听器来实现个性化的外观,并在调用影响外观的操作(比如setEnable)时调用redraw方法强制组件重绘,这是自定义组件常用的实现手段。你会看到接下来的很多方法会经常调用redraw通知组件重绘。

除了setEnabled方法,还有一些方法需要补充,一并列出:

public void setEditable(boolean editable) {
  inputText.setEditable(editable);
 }

public String getText() {
  return inputText.getText();
 }

public void setText(String text) {
  inputText.setText(text);
 }

public void setTextLimit(int limit) {
  inputText.setTextLimit(limit);
 }

这些方法简单易懂,不作解释,以上列举的只是最基本的方法,如果觉得功能不够还可以定义其他方法,例如可以对用户的输入作验证。

接下来回到构造函数中来,QQ、MSN等一些软件的登录除了点击登录按钮执行还可以在用户名、口令输入框上单击回车来实现,为了实现这一功能,需要为基本文本组件添加一个选择监听器。

inputText.addSelectionListener(new SelectionAdapter() {
   @Override
   public void widgetDefaultSelected(SelectionEvent e) {
    commit();
   }
  });

这样,当用户在文本组件上单击回车,会执行commit方法。下面是commit方法的定义:

protected void commit() {
};

它不作任何事情,因为组件不知道实际会应用在何种场合,即回车操作具体作什么,这应该通过继承该组件重写commit方法实现具体功能。

然后为组件添加鼠标监听器,实现用户单击下拉按钮时菜单的弹出。完整代码如下:

addMouseListener(new MouseAdapter() {
   @Override
   public void mouseUp(MouseEvent e) {
    if (e.x > getBounds().width - COMBO_ICON.getBounds().width - 15
      && e.x < getBounds().width && e.y > 0
      && e.y < getBounds().height) {
     selectorMenu.setLocation(getScreemLocation().x + 3,
       getScreemLocation().y + getSize().y + 23);
     selectorMenu.setVisible(true);
    }
   }
  });

if条件句子是判断鼠标指针的落点是否位于下拉三角的区域内,计算方法读者可以自己思考,之后设置弹出菜单出现的位置,根据前面定义的getScreemLocation方法可方便得出,需要提出的是计算x坐标的“+3”和y坐标的“+23”,为什么要再加上这个整数呢?是因为Windows窗口的标题栏高20像素,而getScreemLocation是无法自动计算出的,有些窗口可通过设置将标题栏去掉(SWT的Shell通过指定SWT.NO_TRIM样式实现)“+3是使菜单弹出的位置不至于遮挡组件边框线,因此偏移3像素为最佳位置”。调用setVisible显示菜单,不过前提条件是必须添加了菜单项。构造函数最后是一步是设置组件为可用,虽然任何SWT/Swing组件在构造时默认都是可用的,但是正如前面所述,重写setEnabled并不止设置是否被禁用,重要的是组件在两态下的外观,所以在构造函数最后添加setEnabled(true);


以上讲述过多的是如何装饰组件的外观,接下来的重点将介绍如何用该组件缓存数据,使用MSN时候会发现,单击登录用户名的下拉按钮时候,会弹出所有在本机登录过的用户名列表(如果保存的话),下面讲述如何实现这一功能。


我们的数据均保存在Vector这个集合中,由于实际应用变化万千,组件不可能知道实际保存何种类型的数据,因此Vector的元素类型统一设置为Object,这也实在是一个不错的设计,因为它不强制使用者去实现某某接口,或基类,假如设计成Vector中的元素必须是实现某一特定接口IElement,

private Vector dataSet = new Vector();

这样的话,使用者就必须将其POJO作更改,以适应于此组件,而Object作为所有类的基类,因此可容纳任何类型的数据。接下来的一步很重要,是将数据与菜单关联起来。定义如下方法public void loadMenuItems(Object[] objects),顾名思义是一次性读取一组元素,完整的代码如下:

public void loadMenuItems(Object[] objects) {
  dataSet.clear();
  MenuItem[] items = selectorMenu.getItems();
  for (MenuItem item : items) {
   item.removeSelectionListener(this);
   item.dispose();
  }
  for (int i = 0; i < objects.length; i++) {
   dataSet.add(objects[i]);
   MenuItem item = new MenuItem(selectorMenu, SWT.PUSH);
   item.setText(objects[i].toString());
   item.setData(objects[i]);
   item.addSelectionListener(this);
  }
 }

因为是load所有数据,所以第一步是将已有的数据清空,包括Vector中的数据和菜单中的菜单项。然后是对传入的Object数组作遍历,对于每一项,将之添加进集合然后创建一个菜单项,下一步item.setText(objects[i].toString());是设置菜单项的文字,toString()方法是Object的固有方法,但是实际应用时必须重写该方法的实现。接下来是item.setData(objects[i]);为菜单项设置数据,这一步非常重要,SWT的每一个组件都具有public void setData (Object data)和public Object getData ()方法。还有Hash结构的public void setData (String key, Object value)和public Object getData (String key)。稍后会看到通过item.getData();取出创建时存入的数据。最后一行是为菜单项添加事件监听器,并使组件本身作为监听器,使组件本身实现SelectionListener接口,然后添加下面两个方法:

public final void widgetDefaultSelected(SelectionEvent e)

public final void widgetSelected(SelectionEvent e)

其中widgetDefaultSelected在单击回车时触发,对文本框这样的组件适用,widgetSelected是鼠标单击时触发适用于按钮、菜单项。因此我们只处理widgetSelected。

public final void widgetSelected(SelectionEvent e) {
  MenuItem item = (MenuItem) e.getSource();
  selectedItem = item.getData();
  String text = item.getData().toString();
  inputText.setText(text);
  inputText.setSelection(0, text.length());
  selected(item.getData());
 }

首先取得事件源即单击的菜单项,然后更新selectedItem引用指向这个菜单项保存的数据(先前通过setData方法添加的),接下来的代码不作解释,很容易理解。值得注意的是最后一行selected(item.getData());作用是当用户选中菜单某一项时,根据当前选择的那个数据自动执行相应的操作,selected方法定义如下:

protected void selected(Object object) {
};

与commit方法一样,是需要根据实际情况自定义处理逻辑的。

最后添加如下2个方法:

public void select(int index) {
  MenuItem[] items = selectorMenu.getItems();
  if (index < 0 || index >= items.length) {
   throw new ArrayIndexOutOfBoundsException(
     "the index value must between " + 0 + "and "
       + (items.length - 1));
  }
  selectedItem = items[index].getData();
  inputText.setText(items[index].getText());
 }

select用来设置当前选择第几个项,getSelectedItem返回当前用户选择的数据。


到此为止,ComboSelector已经完成,可以作为API使用了,下面我们编写一个程序测试该组件。

首先编写一个POJO,如下:

package swt.custom;

public class Person {
 private String userName;

 private String password;

 public Person(String userName, String password) {
  this.userName = userName;
  this.password = password;
 }

 public String getPassword() {
  return password;
 }

 public String getUserName() {
  return userName;
 }

 @Override
 public String toString() {
  return userName;
 }
}

简单至极的一个类,注意它的toString方法,返回用户名属性作为显示。

接下来通过一个demo看看实际运行效果。
用swt-designer工具创建一个Shell,在createContents方法体内添加如下代码:

final ComboSelector selector = new ComboSelector(this) {
   @Override
   protected void commit() {
    System.out.println("current data is "
      + ((Person) getSelectedItem()).getUserName());
   }
   @Override
   protected void selected(Object object) {
    System.out.println(((Person) object).getPassword());
   }
  };
  selector.setBounds(114, 78, 200, 20);
  Person[] persons = new Person[] {
    new Person("play_station3@sina.com", "111111"),
    new Person("rehte@hotmail.com", "222222"),
    new Person("yitong.liu@bea.com", "password"),
    new Person("使用其他Windows Live ID 登录", "no") };
  selector.loadMenuItems(persons);
  selector.select(1);

运行结果如下:

  本程序的完整代码这里下载

posted on 2007-10-23 13:33 sun_java_studio@yahoo.com.cn(电玩) 阅读(10070) 评论(5)  编辑  收藏 所属分类: SWT

评论

# re: 用SWT实现MSN风格的下拉框 2007-10-23 13:44 BeanSoft

支持楼主!  回复  更多评论   

# re: 用SWT实现MSN风格的下拉框 2007-10-24 10:50 翔南

呵呵 不错
又是位SWT的爱好者 HOHO!
  回复  更多评论   

# re: 用SWT实现MSN风格的下拉框 2007-11-01 00:42 Jerry Tao

为什么要把Eclipse的项目发表在NetBeans分类中?!  回复  更多评论   

# re: 用SWT实现MSN风格的下拉框 2008-03-26 19:14 gembin

Good!!!!!!!!!  回复  更多评论   

# re: 用SWT实现MSN风格的下拉框 2012-07-05 19:55 gaofeng

你好,您的代码能共享下吗?出售也行。有意向请Q我:178714646  回复  更多评论   


只有注册用户登录后才能发表评论。


网站导航:
 
TWaver中文社区