开发手册 欢迎您!
软件开发者资料库

GWT - 事件处理

GWT事件处理 - 从简单和简单的步骤学习Google Web Toolkit(GWT)编程,从基本到高级概念,包括概述,环境设置,Web应用程序创建,部署和调试应用程序,CSS样式,组件模型,基本,表单和复杂小部件,布局面板,事件处理,自定义小部件,UIBinder,RPC通信,JUnit集成,国际化,历史类,书签支持,日志框架。

GWT提供类似于Java AWT或SWING用户界面框架的事件处理程序模型.

  • 侦听器接口定义一个或者小部件调用以宣告事件的更多方法. GWT提供了与各种可能事件对应的接口列表.

  • 希望接收特定类型事件的类实现关联的处理程序接口,然后传递引用自己到窗口小部件订阅一组事件.

例如, Button 类发布点击活动所以您必须编写一个类来实现 ClickHandler 来处理点击事件.

事件处理程序接口

所有GWT事件处理程序都是从 EventHandler 接口扩展而来的,每个处理程序只有一个方法只有一个论点.此参数始终是关联事件类型的对象.每个事件对象都有许多方法来操作传递的事件对象.例如,对于click事件,您将必须编写处理程序,如下所示 :

/** * create a custom click handler which will call  * onClick method when button is clicked. */public class MyClickHandler implements ClickHandler {   @Override   public void onClick(ClickEvent event) {      Window.alert("Hello World!");   }}

现在任何希望接收点击事件的班级都会调用 addClickHandler()进行注册事件处理程序如下 :

/** * create button and attach click handler */Button button = new Button("Click Me!");button.addClickHandler(new MyClickHandler());

支持事件类型的每个小部件都有一个HandlerRegistration形式的方法add Foo Handler( Foo 事件)其中 Foo 是Click,Error,KeyPress等实际事件.

以下是重要的GWT事件处理程序及相关事件和处理程序注册的列表方法 :

Sr.No.事件接口事件方法&说明
1Before Selection Handler< I>

在选择之前无效(选择事件之前< I>事件);

在触发BeforeSelectionEvent时调用.

2BlurHandler

Blur上的void(模糊事件事件);

当Blur事件被触发时调用.

3ChangeHandler

变更无效(ChangeEvent事件) );

触发更改事件时调用.

4ClickHandler

Click on Click(ClickEvent事件);

触发本机点击事件时调用.

5CloseHandler< T>

关闭时无效(CloseEvent< T>事件);

在触发CloseEvent时调用.

6Context Menu Handler

上下文菜单上的void(上下文菜单事件事件);

在触发本机上下文菜单事件时调用.

7Double Click Handler

双击(双击事件事件)无效;

双人时调用点击事件被触发.

8Error Handler

错误时出现错误(错误事件事件);

触发错误事件时调用.

9Focus Handler

无效焦点(焦点事件)事件);

在焦点事件被触发时调用.

10Form Panel.Submit Complete Handler

提交完成时无效(表单面板.提交完成事件事件);

成功提交表单时触发.

11FormPanel.SubmitHandler

提交时无效(表单Panel.Submit事件事件);

表单时触发提交.

12Key Down Handler

按键按下时无效(按键事件事件);

触发KeyDownEvent时调用.

13KeyPressHandler

在KeyPress上无效(KeyPressEvent事件);

在触发KeyPressEvent时调用.

14KeyUpHandler

在KeyUp上无效(KeyUpEvent事件);

在触发KeyUpEvent时调用.

15LoadHandler

加载时无效(LoadEvent事件);

在触发LoadEvent时调用.

16MouseDownHandler

在MouseDown上无效(MouseDownEvent事件);

在MouseDown被触发时调用.

17MouseMoveHandler

无效MouseMove(MouseMoveEvent事件);

触发MouseMoveEvent时调用.

18MouseOutHandler

在MouseOut上无效(MouseOutEvent事件);

在触发MouseOutEvent时调用.

19MouseOverHandler

在MouseOver上无效(MouseOverEvent事件);

在触发MouseOverEvent时调用.

20MouseUpHandler

在MouseUp上无效(MouseUpEvent事件);

在MouseUpEvent时调用被解雇.

21MouseWheelHandler

在MouseWheel上无效(MouseWheelEvent事件);

在触发MouseWheelEvent时调用.

22ResizeHandler

调整大小时无效(ResizeEvent事件);

调整小部件大小时触发.

23ScrollHandler

滚动时无效(滚动事件事件);

触发ScrollEvent时调用.

24SelectionHandler< I>
选择时

无效(SelectionEvent< I>事件);

当LaserEvent被触发时调用.

25ValueChangeHandler< I>

在ValueChange上为void(ValueChangeEvent< I>事件);

在触发ValueChangeEvent时调用.

26Window.ClosingHandler

WindowClosing上的void(Window.ClosingEvent事件);

在浏览器窗口关闭之前触发或导航到另一个站点.

27Window.ScrollHandler

在WindowScroll上无效(Window.ScrollEvent事件);

滚动浏览器窗口时触发.

事件方法

如前所述,每个处理程序都有一个方法,只有一个参数保存事件ob ject,例如 void onClick(ClickEvent事件) void onKeyDown(KeyDownEvent事件).像 ClickEvent KeyDownEvent 这样的事件对象有几个常见的方法,列在下面 :

Sr.No.Method&描述
1

protected void dispatch(ClickHandler handler)此方法只能由HandlerManager调用

2

DomEvent.Type< FooHandler> getAssociatedType()此方法返回用于注册 Foo 事件的类型.

3

static DomEvent.Type< FooHandler> getType()此方法获取与 Foo 事件关联的事件类型.

4

public java.lang.Object getSource() this method返回上次触发此事件的源.

5

protected final boolean isLive()此方法返回事件是否有效.

6

protected void kill()此方法终止事件

示例

此示例将指导您完成在GWT中显示单击事件和 KeyDown 事件处理的使用的简单步骤.按照以下步骤更新我们在 GWT  - 创建应用程序章节中创建的GWT应用程序;

步骤描述
1在包 com.it1352下创建一个名为 HelloWorld 的项目,如下所述在 GWT  - 创建应用程序章节.
2修改 HelloWorld.gwt.xml HelloWorld.css HelloWorld.html HelloWorld.java 如下所述.保持其余文件不变.
3编译并运行应用程序以验证实现的逻辑的结果.

以下是修改后的模块描述符的内容 src/com.it1352/HelloWorld.gwt.xml.

                           

以下是修改后的样式表文件的内容 war/HelloWorld.css .

body {   text-align: center;   font-family: verdana, sans-serif;}h1 {   font-size: 2em;   font-weight: bold;   color: #777777;   margin: 40px 0px 70px;   text-align: center;}

以下是修改过的HTML主机文件的内容 war/HelloWorld.html .

         Hello World                              

Event Handling Demonstration

      
   

让我们有以下Java文件 src/com.it1352/HelloWorld.java 的内容,它将演示事件处理的使用在GWT.

package com.it1352.client; import com.google.gwt.core.client.EntryPoint;import com.google.gwt.event.dom.client.ClickEvent;import com.google.gwt.event.dom.client.ClickHandler;import com.google.gwt.event.dom.client.KeyCodes;import com.google.gwt.event.dom.client.KeyDownEvent;import com.google.gwt.event.dom.client.KeyDownHandler;import com.google.gwt.user.client.Window;import com.google.gwt.user.client.ui.Button;import com.google.gwt.user.client.ui.DecoratorPanel;import com.google.gwt.user.client.ui.HasHorizontalAlignment;import com.google.gwt.user.client.ui.RootPanel;import com.google.gwt.user.client.ui.TextBox;import com.google.gwt.user.client.ui.VerticalPanel;public class HelloWorld implements EntryPoint {   public void onModuleLoad() {      /**       * create textbox and attach key down handler       */      TextBox textBox = new TextBox();       textBox.addKeyDownHandler(new MyKeyDownHandler());      /*       * create button and attach click handler       */      Button button = new Button("Click Me!");      button.addClickHandler(new MyClickHandler());      VerticalPanel panel = new VerticalPanel();      panel.setSpacing(10);      panel.setHorizontalAlignment(HasHorizontalAlignment.ALIGN_CENTER);      panel.setSize("300", "100");      panel.add(textBox);      panel.add(button);      DecoratorPanel decoratorPanel = new DecoratorPanel();      decoratorPanel.add(panel);      RootPanel.get("gwtContainer").add(decoratorPanel);   }   /**     * create a custom click handler which will call     * onClick method when button is clicked.    */   private class MyClickHandler implements ClickHandler {      @Override      public void onClick(ClickEvent event) {         Window.alert("Hello World!");      }   }   /**    * create a custom key down handler which will call     * onKeyDown method when a key is down in textbox.    */   private class MyKeyDownHandler implements KeyDownHandler {      @Override      public void onKeyDown(KeyDownEvent event) {         if(event.getNativeKeyCode() == KeyCodes.KEY_ENTER){            Window.alert(((TextBox)event.getSource()).getValue());         }      }   }}

准备完成所有更改后,让我们像在 GWT  - 创建应用程序一章中那样在开发模式下编译和运行应用程序.如果您的应用程序一切正常,这将产生以下结果 :

GWT事件处理