当前位置: 首页 > 文档资料 > GWT 入门教程 >

事件处理(Event Handling)

优质
小牛编辑
132浏览
2023-12-01

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

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

  • 希望接收特定类型事件的类实现关联的处理程序接口,然后将对其自身的引用传递给窗口小部件以订阅一组事件。

例如, Button类发布click events因此您必须编写一个类来实现ClickHandler来处理click事件。

事件处理程序接口

所有GWT事件处理程序都已从EventHandler接口扩展,并且每个处理程序只有一个带有单个参数的方法。 此参数始终是关联事件类型的对象。 每个event对象都有许多方法来操纵传递的事件对象。 例如,对于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形式的方法添加Foo Handler( Foo事件),其中Foo是实际事件,如Click,Error,KeyPress等。

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

Sr.No.事件接口事件方法和描述
1在选择处理程序之前

void on Before Selection (Before Selection Event《I》 event);

在触发BeforeSelectionEvent时调用。

2BlurHandler

void on Blur(Blur Event event);

在模糊事件被触发时调用。

3ChangeHandler

void on Change(ChangeEvent event);

触发更改事件时调用。

4ClickHandler

void on Click(ClickEvent event);

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

5CloseHandler<T>

void on Close(CloseEvent《T》 event);

在触发CloseEvent时调用。

6上下文菜单处理程序

void on Context Menu(Context Menu Event event);

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

7双击处理程序

void on Double Click(Double Click Event event);

触发双击事件时调用。

8错误处理程序

void on Error(Error Event event);

触发错误事件时调用。

9焦点处理程序

void on Focus(Focus Event event);

在Focus事件被触发时调用。

10Form Panel.Submit Complete Handler

void on Submit Complete(Form Panel.Submit Complete Event event);

成功提交表单时触发。

11FormPanel.SubmitHandler

void on Submit(Form Panel.Submit Event event);

提交表单时触发。

12按键处理程序

void on Key Down(Key Down Event event);

在触发KeyDownEvent时调用。

13KeyPressHandler

void on KeyPress(KeyPressEvent event);

触发KeyPressEvent时调用。

14KeyUpHandler

void on KeyUp(KeyUpEvent event);

在触发KeyUpEvent时调用。

15LoadHandler

void on Load(LoadEvent event);

在触发LoadEvent时调用。

16MouseDownHandler

void on MouseDown(MouseDownEvent event);

在MouseDown被触发时调用。

17MouseMoveHandler

void on MouseMove(MouseMoveEvent event);

在触发MouseMoveEvent时调用。

18MouseOutHandler

void on MouseOut(MouseOutEvent event);

在触发MouseOutEvent时调用。

19MouseOverHandler

void on MouseOver(MouseOverEvent event);

在触发MouseOverEvent时调用。

20MouseUpHandler

void on MouseUp(MouseUpEvent event);

在MouseUpEvent被触发时调用。

21MouseWheelHandler

void on MouseWheel(MouseWheelEvent event);

在触发MouseWheelEvent时调用。

22ResizeHandler

void on Resize(ResizeEvent event);

调整窗口小部件时触发。

23ScrollHandler

void on Scroll(ScrollEvent event);

触发ScrollEvent时调用。

24SelectionHandler<I>

void on Selection(SelectionEvent《I》 event);

在SelectionEvent被触发时调用。

25ValueChangeHandler<I>

void on ValueChange(ValueChangeEvent《I》 event);

触发ValueChangeEvent时调用。

26Window.ClosingHandler

void on WindowClosing(Window.ClosingEvent event);

在浏览器窗口关闭或导航到其他站点之前触发。

27Window.ScrollHandler

void on WindowScroll(Window.ScrollEvent event);

滚动浏览器窗口时触发。

事件方法

如前所述,每个处理程序都有一个方法,其中包含一个保存事件对象的参数,例如void onClick(ClickEvent event)void onKeyDown(KeyDownEvent event)ClickEventKeyDownEvent等事件对象的常用方法很少,如下所示 -

Sr.No.方法和描述
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()此方法返回上次触发此事件的源。

5

protected final boolean isLive()此方法返回事件是否为活动。

6

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

例子 (Example)

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

描述
1com.

包下创建一个名为HelloWorld的项目,如GWT - Create Application一章中所述。
2修改HelloWorld.gwt.xmlHelloWorld.cssHelloWorld.htmlHelloWorld.java ,如下所述。 保持其余文件不变。
3编译并运行应用程序以验证实现的逻辑的结果。

以下是修改后的模块描述符src/com.

/HelloWorld.gwt.xml 。

<?xml version = "1.0" encoding = "UTF-8"?>
<module rename-to = 'helloworld'>
   <!-- Inherit the core Web Toolkit stuff.                        -->
   <inherits name = 'com.google.gwt.user.User'/>
   <!-- Inherit the default GWT style sheet.                       -->
   <inherits name = 'com.google.gwt.user.theme.clean.Clean'/>
   <!-- Specify the app entry point class.                         -->
   <entry-point class = 'com.

.client.HelloWorld'/> <!-- Specify the paths for translatable code --> <source path = 'client'/> <source path = 'shared'/> </module>

以下是修改后的样式表文件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

<html>
   <head>
      <title>Hello World</title>
      <link rel = "stylesheet" href = "HelloWorld.css"/>
      <script language = "javascript" src = "helloworld/helloworld.nocache.js">
      </script>
   </head>
   <body>
      <h1>Event Handling Demonstration</h1>
      <div id = "gwtContainer"></div>
   </body>
</html>

让我们有以下Java文件src/com.

/HelloWorld.java ,它将演示在GWT中使用事件处理。

package com.

.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事件处理