用Java SWT实现MSN风格的下拉框

  • 来源: 天极网 作者: 若水   2008-05-12/18:20
  • SWT一个所谓的优点是它的本地化外观,因为它是通过JNI调用操作系统的组件,从而可以保证外观上适合大多数用户的需求,但是一些IM类软件商往往希望它们的产品有着一套独特的外观,这对SWT这种原生组件来说就有些力不从心了,严格来说如果你的用户对外观要求比较苛刻,那么Swing是首选,因为L&F机制可以确保你做到这一点,另外Swing还有着许多SWT不具备的优点,例如半透明组件、渲染等,但是少数的这些特性用SWT还是可以模拟的,本文就向大家介绍如何通过自定义组件实现MSN风格的下拉框。

    通常来说,SWT提供的组件集基本上能满足大多数用户的需求,而自定义组件通常分为2种,一种是将若干基本组件组合成一个复合组件(如日历组件);第二是对现有组件改善外观从而符合客户的要求;或者将这两种混合使用。利用SWT实现自定义组件通常要继承Composite或Canvas来实现,但是绝大多数采用继承Composite实现,如果你查看SWT的源代码,你会发现很多SWT高级组件(如ExpandBar)都是直接继承Composite来实现的。

    如果要模拟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);

    #p#分页标题#e#


    首先实现父组件的构造器,注意,将风格设置为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();
    }
    });

    #p#分页标题#e#


    这样,当用户在文本组件上单击回车,会执行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。#p#分页标题#e#

    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);

     


    评论 {{userinfo.comments}}

    {{money}}

    {{question.question}}

    A {{question.A}}
    B {{question.B}}
    C {{question.C}}
    D {{question.D}}
    提交

    驱动号 更多