SWT事件

[url]http://www.pcjx.com/Java/Eclipse/206903.html[/url]


在窗口系统中，程序一般都是以事件驱动的。SWT的Control类实现了一些事件监听的注册方法，其子类都可以通过这些方法注册鼠标和键盘的监听器，通过实现这些监听器的接口，窗口组件就能响应相应的鼠标和键盘事件。

Control类是窗口组件类的基类，它定义了基本的事件监听方法，有如下一些：

addControlListener

addFocusListener

addHelpListener

addKeyListener

addMouseListener

addMouseTrackListener

addMouseMoveListener

addPaintListener

addTraverseListener

添加事件监听器步骤如下：
1. 创建事件监听器。例如：“new KeyListener()…”。
2. 通过Control类的子类添加事件监听器。例如：“text.addKeyListener()”。

常用事件有鼠标事件、键盘事件、焦点事件、窗口控制事件和选择事件，Control类的子类也可以定义添加相关的监听方法。


鼠标事件

在窗口系统中，鼠标基本上是必备的设备。一般来说，窗口中鼠标有鼠标单击、鼠标双击、鼠标进入窗口、鼠标退出窗口及鼠标移动等事件。

在SWT中，事件的响应是通过相应接口实现的，每个组件可以添加相应的事件响应实例来监听事件。例如“button.addMouseListener(listener)”，表示在button组件上添加鼠标的相应响应事件实例，其中，listener为实现监听器对象，下面就具体的鼠标事件进行介绍。

MouseListener接口

在SWT中，通过实现MouseListener接口来响应鼠标的按下、松开及双击事件，MouseListener接口如例程1所示。
例程1 MouseListener.java
package org.eclipse.swt.events;

import org.eclipse.swt.internal.SWTEventListener;

public interface MouseListener extends SWTEventListener {

public void mouseDoubleClick(MouseEvent e);

public void mouseDown(MouseEvent e);

public void mouseUp(MouseEvent e);

}

其中，mouseDoubleClick表示鼠标双击事件响应方法，mouseDown表示鼠标键按下事件的响应方法，mouseUp表示鼠标键起来事件的响应方法，MouseEvent为系统传入的鼠标事件的参数，MouseEvent中的button属性表示鼠标的按钮值，例如e.button等于1，表示鼠标左键按下，按钮值对应鼠标按钮如表1所示。
[img]http://www.pcjx.com/Java/UploadFiles_7463/200802/2008217124845333.jpg[/img]


在程序中，开发人员可以根据e.button的值判断当前用户按的是哪一个鼠标键，从而确定采用什么操作。

MouseMoveListener接口

在SWT中，通过实现MouseMoveListener接口来响应鼠标的移动事件，MouseMoveListener接口如例程2所示。
例程2 MouseMoveListener.java

package org.eclipse.swt.events;

import org.eclipse.swt.internal.SWTEventListener;

public interface MouseMoveListener extends SWTEventListener {

public void mouseMove(MouseEvent e);

}

MouseMoveListener只有mouseMove方法，用来响应窗口中鼠标移动事件。

MouseTrackListener接口

在SWT中，通过实现MouseTrackListener接口来响应鼠标进入窗口、鼠标退出窗口和鼠标停放在窗口上的事件，MouseTrackListener接口如例程3所示。

例程3 MouseTrackListener.java

package org.eclipse.swt.events;

import org.eclipse.swt.internal.SWTEventListener;

public interface MouseTrackListener extends SWTEventListener {

public void mouseEnter(MouseEvent e);

public void mouseExit(MouseEvent e);

public void mouseHover(MouseEvent e);

}

其中，mouseEnter表示鼠标进入窗口事件的响应方法，mouseExit表示鼠标退出窗口事件的响应方法，mouseHover表示鼠标停放在窗口上事件的响应方法。

鼠标事件实例

为了更深入地理解鼠标事件，下面通过具体的实例演示如何响应鼠标事件。该程序只是当事件触发时简单地打印出相应信息，在具体的实例中，读者可以根据需要进行修改，代码如例程4所示。
例程4 MouseEventExample.java

/**

* 为了节省篇幅，所有的import类已经被注释

* 读者可以通过ctrl+shift+o快捷键，自动引入所依赖的类

* 如果有问题可发邮件到ganshm@gmail.com

* */

public class MouseEventExample implements MouseListener, MouseMoveListener,

MouseTrackListener {

//显示信息的标签

Label myLabel = null;

Shell shell = null;

public MouseEventExample() {

}

public void run() {

Display display = new Display();

Shell shell = new Shell(display);

shell.setLayout(new GridLayout());

shell.setSize(450, 200);

shell.setText("Mouse Event Example");

myLabel = new Label(shell, SWT.BORDER);

myLabel.setText("I ain't afraid of any old mouse");

//在当前窗口上添加鼠标响应事件

shell.addMouseListener(this);

shell.addMouseMoveListener(this);

shell.addMouseTrackListener(this);

shell.open();

while (!shell.isDisposed()) {

if (!display.readAndDispatch()) {

display.sleep();

}

}

display.dispose();

}

public static void main(String[] args) {

new MouseEventExample().run();

}

public void mouseDoubleClick(MouseEvent e) {

myLabel.setText("Double Click " + e.button + " at: " + e.x + "," + e.y);

System.out.println("Double Click " + e.button + " at: " + e.x + ","

+ e.y);

}

public void mouseDown(MouseEvent e) {

myLabel.setText("Button " + e.button + " Down at: " + e.x + "," + e.y);

System.out.println("Button " + e.button + " Down at: " + e.x + ","

+ e.y);

}

public void mouseUp(MouseEvent e) {

myLabel.setText("Button " + e.button + " Up at: " + e.x + "," + e.y);

System.out.println("Button " + e.button + " Up at: " + e.x + "," + e.y);

}

public void mouseMove(MouseEvent e) {

myLabel.setText("Mouse Move at: " + e.x + "," + e.y);

System.out.println("Mouse Move at: " + e.x + "," + e.y);

}

public void mouseEnter(MouseEvent e) {

myLabel.setText("Mouse Enter at: " + e.x + "," + e.y);

System.out.println("Mouse Enter at: " + e.x + "," + e.y);

}

public void mouseExit(MouseEvent e) {

myLabel.setText("Mouse Exit at: " + e.x + "," + e.y);

System.out.println("Mouse Exit at: " + e.x + "," + e.y);

}

public void mouseHover(MouseEvent e) {

myLabel.setText("Mouse Hover at: " + e.x + "," + e.y);

System.out.println("Mouse Hover at: " + e.x + "," + e.y);

}

}

MouseEventExample类实现了MouseListener、MouseMoveListener和MouseTrackListener 3个接口，并通过“shell.addMouseListener(this);”、“shell.addMouseMoveListener(this);”和“shell.addMouseTrackListener(this);”把自己作为监听器添加到了窗口中，程序运行效果如图1所示。
[img]http://www.pcjx.com/Java/UploadFiles_7463/200802/2008217124845288.jpg[/img]

图1 鼠标事件实例




键盘事件

键盘事件是最简单，也是最常用的事件。一般来说，键盘事件有两种：键按下和键松开。SWT通过KeyListener响应键盘事件。

KeyListener接口

在SWT中，通过实现KeyListener接口来响应键按下和松开的事件。KeyListener接口如例程5所示。
例程5 KeyListener.java
package org.eclipse.swt.events;

import org.eclipse.swt.internal.SWTEventListener;

public interface KeyListener extends SWTEventListener {

public void keyPressed(KeyEvent e);

public void keyReleased(KeyEvent e);

}

其中，keyPressed表示键按下事件的响应方法，keyReleased表示键松开事件的响应方法，KeyEvent为系统传入的键盘事件的参数，用户可以通过KeyEvent参数找到相应的按键值。


键盘事件实例

为了更深入地了解键盘事件，下面通过具体的实例演示如何响应键盘事件。该程序只是当事件触发时简单地打印出相应信息，在具体的实例中，读者可以根据需要进行修改，代码如例程6所示。
例程6 KeyListenerExample.java

public class KeyListenerExample {

Display display;

Shell shell;

KeyListenerExample() {

display = new Display();

shell = new Shell(display);

shell.setSize(250, 200);

shell.setText("A KeyListener Example");

Text text = new Text(shell, SWT.BORDER);

text.setBounds(50 ,50 ,100, 20);

text.addKeyListener(new KeyListener() {

public void keyPressed(KeyEvent e) {

System.out.println("key Pressed -"+e.character);

}

public void keyReleased(KeyEvent e) {

System.out.println("key Released -"+e.character);

}

});

shell.open();

while (!shell.isDisposed()) {

if (!display.readAndDispatch())

display.sleep();

}

display.dispose();

}

public static void main(String[] args) {

new KeyListenerExample();

}

}

程序中通过匿名内部类实现监听器，这种方式在实例开发中会经常用到。另外可以通过KeyEvent取得按键的值，如上例的“e.character”得到按键的字符，程序运行效果如图2所示
[img]http://www.pcjx.com/Java/UploadFiles_7463/200802/2008217124845778.jpg[/img]
图2键盘事件




焦点事件

在窗口系统中，当组件获得输入焦点或失去焦点时将触发相应的事件。SWT通过FocusListener监听焦点事件。

FocusListener接口

在SWT中，通过实现FocusListener接口来响应获得焦点和失去焦点的事件。FocusListener接口如例程7所示。
例程7 FocusListener.java
package org.eclipse.swt.events;

import org.eclipse.swt.internal.SWTEventListener;

public interface FocusListener extends SWTEventListener {

public void focusGained(FocusEvent e);

public void focusLost(FocusEvent e);

}

其中，focusGained表示组件获得焦点事件的响应方法，focusLost表示组件失去焦点事件的响应方法，FocusEvent为系统传入的焦点事件的参数，用户可以通过FocusEvent参数找到相应的组件。

焦点事件实例

为了更深入地理解焦点事件，下面通过具体的实例演示如何响应焦点事件。该程序只是简单地改变当前获得焦点和失去焦点组件的显示信息，在具体的实例中，读者可以根据需要进行修改，代码如例程8所示。

例程8 FocusListenerExample.java

public class FocusListenerExample {

public static void main(String[] args) {

Display display = new Display();

Shell shell = new Shell(display);

shell.setLayout(new GridLayout(3, true));

shell.setText("One Potato, Two Potato");

//新建焦点监听器

FocusListener listener = new FocusListener() {

public void focusGained(FocusEvent event) {

//获得触发事件的组件

Button button = (Button) event.getSource();

　　　　//焦点获得时改变显示文本

button.setText("I'm It!");

}

public void focusLost(FocusEvent event) {

　　　　//获得触发事件的组件

Button button = (Button) event.getSource();

//焦点获得时改变显示文本

button.setText("Pick Me!");

}

};

for (int i = 0; i < 6; i++) {

Button button = new Button(shell, SWT.PUSH);

button.setLayoutData(new GridData(GridData.FILL_HORIZONTAL));

button.setText("Pick Me!");

button.addFocusListener(listener);

}

shell.pack();

shell.open();

while (!shell.isDisposed()) {

if (!display.readAndDispatch()) {

display.sleep();

}

}

display.dispose();

}

}

程序中显示了6个按钮，并为按钮添加上了焦点监听器，程序运行效果如图3所示。
[img]http://www.pcjx.com/Java/UploadFiles_7463/200802/2008217124845548.jpg[/img]

图3 焦点事件实例



窗口控制事件

在窗口系统中，当组件被移动或改变大小时将触发相应的事件。SWT通过ControlListener监听窗口控制事件。

ControlListener接口

在SWT中，通过实现ControlListener接口来响应组件被移动或改变大小的事件。ControlListener接口如例程9所示。

例程9 ControlListener.java
package org.eclipse.swt.events;

import org.eclipse.swt.internal.SWTEventListener;

public interface ControlListener extends SWTEventListener {

public void controlMoved(ControlEvent e);

public void controlResized(ControlEvent e);

}

其中，controlMoved表示组件被移动事件的响应方法，controlResized表示组件被改变大小事件的响应方法，ControlEvent为系统传入的窗口控制事件的参数，用户可以通过ControlEvent参数找到相应的组件。

窗口控制事件实例

为了更深入地理解窗口控制事件，下面通过具体的实例演示如何响应窗口控制事件。该程序只是简单地打印组件被移动或改变大小的信息，在具体的实例中，读者可以根据需要进行修改，代码如例程10所示。

例程10 ControlListenerExample.java

public class ControlListenerExample {

public void run() {

Display display = new Display();

Shell shell = new Shell(display);

shell.addControlListener(new ControlListener() {

public void controlMoved(ControlEvent e) {

System.out.println("control move");

}

public void controlResized(ControlEvent e) {

System.out.println("control resize");

}

}

);

shell.pack();

shell.open();

while (!shell.isDisposed()) {

if (!display.readAndDispatch()) {

display.sleep();

}

}

display.dispose();

}

public static void main(String[] args) {

new ControlListenerExample().run();

}

}

上例显示的只是一个空白的窗口，当用户移动窗口或改变窗口大小时，将会触发监听器所实现的事件。



选择事件

SWT的很多组件都实现了选择组件事件的监听机制，例如按钮、菜单项的选择，当选择了相关的菜单项或组件时，将触发相应的事件。

SelectionListener接口

在SWT中，通过实现SelectionListener接口来响应选择组件事件。SelectionListener接口如例程11所示。
例程11 SelectionListener.java
package org.eclipse.swt.events;

import org.eclipse.swt.internal.SWTEventListener;

public interface SelectionListener extends SWTEventListener {

public void widgetSelected(SelectionEvent e);

public void widgetDefaultSelected(SelectionEvent e);

}

其中，widgetSelected表示组件被选择事件的响应方法，widgetDefaultSelected表示组件默认选择事件的响应方法，SelectionEvent为系统传入的选择事件的参数。

选择组件事件实例

为了更深入地理解选择组件事件，下面通过具体的实例演示如何响应选择组件事件。该程序只是简单地打印组件被移动或改变大小的信息，在具体的实例中，读者可以根据需要进行修改，代码如例程12所示。

例程12 SelectonListenerExample.java

public class SelectonListenerExample {

public static void main(String[] args) {

Display display = new Display();

final Shell mainShell = new Shell(display);

Button button = new Button(mainShell, SWT.PUSH);

button.setText("Close Me!");

button.setBounds(10, 10, 100, 30);

// 添加选择组件事件

button.addSelectionListener(new SelectionListener() {

public void widgetSelected(SelectionEvent event) {

System.out.println("select button");

mainShell.close();

}

public void widgetDefaultSelected(SelectionEvent e) {

// 不执行任何操作

}

});

mainShell.open();

while (!mainShell.isDisposed()) {

if (!display.readAndDispatch()) {

display.sleep();

}

}

display.dispose();

}

}

上例中只是添加了一个按钮，当选择按钮时关闭当前窗口。






其他常用事件

SWT中为了实现特定的功能，很多组件都提供了特定事件的响应，本节将通过实例介绍HelpListener、VerifyListener和ModifyListener 3个特定的事件监听器。

HelpListener、VerifyListener和ModifyListener监听器的功能

HelpListener监听器通过helpRequested(HelpEvent e)方法响应用户的帮助请求事件，当用户在组件获得焦点后按【F1】键将触发此事件。

VerifyListener监听器通过verifyText(VerifyEvent e)方法响应校验输入事件。此监听器只对文本输入校验，当用户输入了数据后，verifyText方法将通过设置VerifyEvent中的doit属性判断输入是否正确，从而确定修改是否有效。doit属性为true时修改有效，即“e.doit = true;”。

ModifyListener监听器通过modifyText(ModifyEvent e)方法响应文本被修改的事件。此监听器只对文本输入校验。
提示：如果VerifyListener监听器和ModifyListener监听器同时存在的话，会先响应校验输入事件，如果校验成功再响应修改事件。

HelpListener、VerifyListener和ModifyListener监听器实例

在此实例中，用户可以输入华氏温度和摄氏温度，通过监听器判断输入是否正确及计算相应的摄氏温度和华氏温度，另外，还可以按【F1】键获得当前组件的信息，代码如例程13所示。

例程13 MultipleListenersExample.java

public class MultipleListenersExample implements HelpListener, VerifyListener,

ModifyListener {

private static final double FIVE_NINTHS = 5.0 / 9.0;

private static final double NINE_FIFTHS = 9.0 / 5.0;

private Text fahrenheit;

private Text celsius;

private Label help;

public void run() {

Display display = new Display();

Shell shell = new Shell(display);

shell.setText("Temperatures");

createContents(shell);

shell.pack();

shell.open();

while (!shell.isDisposed()) {

if (!display.readAndDispatch()) {

display.sleep();

}

}

display.dispose();

}

private void createContents(Shell shell) {

shell.setLayout(new GridLayout(3, true));

new Label(shell, SWT.LEFT).setText("Fahrenheit:");

fahrenheit = new Text(shell, SWT.BORDER);

GridData data = new GridData(GridData.FILL_HORIZONTAL);

data.horizontalSpan = 2;

fahrenheit.setLayoutData(data);

fahrenheit.setData("Type a temperature in Fahrenheit");

// 为华氏温度文本框添加监听器

fahrenheit.addHelpListener(this);

fahrenheit.addVerifyListener(this);

fahrenheit.addModifyListener(this);

new Label(shell, SWT.LEFT).setText("Celsius:");

celsius = new Text(shell, SWT.BORDER);

data = new GridData(GridData.FILL_HORIZONTAL);

data.horizontalSpan = 2;

celsius.setLayoutData(data);

celsius.setData("Type a temperature in Celsius");

//为摄氏温度文本框添加监听器

celsius.addHelpListener(this);

celsius.addVerifyListener(this);

celsius.addModifyListener(this);

help = new Label(shell, SWT.LEFT | SWT.BORDER);

data = new GridData(GridData.FILL_HORIZONTAL);

data.horizontalSpan = 3;

help.setLayoutData(data);

}

//响应帮助事件

public void helpRequested(HelpEvent event) {

help.setText((String) event.widget.getData());

}

　//响应校验事件

public void verifyText(VerifyEvent event) {

event.doit = false;

char myChar = event.character;

String text = ((Text) event.widget).getText();

if (myChar == '-' && text.length() == 0) event.doit = true;

if (Character.isDigit(myChar)) event.doit = true;

if (myChar == '\b') event.doit = true;

}

　//响应文本修改的事件

public void modifyText(ModifyEvent event) {

// 删除监听器，从而在modifyText过程中不会触发事件

celsius.removeVerifyListener(this);

celsius.removeModifyListener(this);

fahrenheit.removeVerifyListener(this);

fahrenheit.removeModifyListener(this);

Text text = (Text) event.widget;

try {

int temp = Integer.parseInt(text.getText());

if (text == fahrenheit) {

celsius.setText(String.valueOf((int) (FIVE_NINTHS * (temp - 32))));

} else {

fahrenheit.setText(String.valueOf((int) (NINE_FIFTHS * temp + 32)));

}

} catch (NumberFormatException e) { /* Ignore */ }

//添加监听器

celsius.addVerifyListener(this);

celsius.addModifyListener(this);

fahrenheit.addVerifyListener(this);

fahrenheit.addModifyListener(this);

}

public static void main(String[] args) {

new MultipleListenersExample().run();

}

}

程序运行效果如图4所示。
[img]http://www.pcjx.com/Java/UploadFiles_7463/200802/2008217124845997.jpg[/img]

图4 文本监听器


提示：一般来说，监听器都有一个抽象的Adaper类实现监听器的方法，例如FocusAdapter实现了FocusListener的方法（方法为空）。如果读者不想实现监听器的全部方法则可以继承监听器的Adaper类，否则要实现监听器接口的所有方法。