第8章 事件处理
本章内容:
* 事件处理基础
* 动作
* 鼠标事件
* AWT事件继承层次
8.1 事件处理基础
- 在AWT所知的事件范围内,完全可以控制事件从事件源(event source)例如,按钮或滚动条,到事件监听器(event listener)的传递过程,并将任何对象指派给事件监听器。不过事实上,应该选择一个能够便于响应事件的对象。这种事件委托模型(event delegation event)与Visual Basic那种预定义监听器模型比较起来更加灵活。
- 事件源有一些向其注册事件监听器的方法。当某个事件源产生事件时,事件源会向为事件注册的所有事件监听器对象发送一个通告。
- 像Java这样的面向对象语言,都将事件的相关信息封装在一个事件对象(event object)中。在Java中,所有的事件对象都最终派生于java.util.EventObject类。
- 不同的事件源可以产生不同类别的事件。
- AWT事件处理机制的概要:
- 监听器对象是一个实现了特定监听器接口(listener interface)的类的实例。
- 事件源是一个能够注册监听器对象并发送事件对象的对象。
- 当事件发生时,事件源将事件对象传递给所有注册的监听器。
- 监听器对象将利用事件对象中的信息决定如何对事件做出响应。
8.1.1 实例:处理按钮点击事件
- 可以通过在按钮构造器中指定一个标签字符串、一个图标或两项都指定来创建一个按钮。
- ActionListener接口并不仅限于按钮点击事件。它可以应用于很多情况:
- 当采用鼠标双击的方式选择了列表框中的一个选项时;
- 当选择一个菜单项时;
- 当在文本域中按回车键时;
- 对于一个Timer组件来说,当达到指定的时间间隔时。
在所有这些情况下,使用ActionListener接口的方式都是一样的:actionPerformed方法(ActionListener中的唯一方法)将接收一个ActionEvent类型的对象作为参数。这个事件对象包含了事件发生时的相关信息。
- 事件监听器对象通常需要执行一些对其他对象可能产生影响的操作。可以策略性地将监听器类放置在需要修改状态的那个类中。
- jaxax.swing.JButton 1.2
- JButton(String label)
- JButton(Icon icon)
- JButton(String label,Icon icon)
构造一个按钮,标签可以是常规的文本,从Java1.3开始,也可以是HTML。
- java.awt.Container 1.0
- Component add(Component c)
将组件c添加到这个容器中。
8.1.2 建议使用内部类
- 内部类机制将自动地生成一个构造器,其中存储着所有用在内部类方法中的final局部变量。
- java.util.EventObject 1.1
- Object getSource()
返回发生事件的对象引用。
- java.awt.event.ActionEvent 1.1
- String getActionCommand()
返回与这个动作事件相关的命令字符串。如果动作事件来源于按钮,命令字符串就等于按钮标签,除非已经使用setActionCommand方法对字符串进行了修改。
8.1.3 创建包含一个方法调用的监听器
- EventHandler类可以使用下列调用,自动地创建这样一个监听器:
EventHandler.create(ActionListener.class,frame,"loadData")
。
- java.beans.EventHandler 1.4
- static Object create(Class listenerInterface,Object target,String action)
- static Object create(Class listenerInterface,Object target, String action,String eventProperty)
- static Object create(Class listenerInterface,Object target,String action,String eventProperty,String listenerMethod)
构造实现给定接口的一个代理类对象。命名方法或接口的所有方法都将在目标对象上执行给定动作。
这个动作可以是一个方法名或目标的一个属性。如果是一个属性,将执行其设置方法。
事件属性包括一个或多个用点号分割的属性名。第一个属性从监听器方法的参数读取,第二个属性由结果对象读取,依次类推。最后的结果将作为动作的参数。
8.1.4 实例:改变观感
- 在默认情况下,Swing程序使用Metal观感,可以采用两种方式改变观感。第一种方式是在Java安装的子目录jre/lib下有一个文件swing.properties。在这个文件中,将属性swing.defaultlaf设置为所希望的观感类名。
注意,Metal观感位于javax.swing包中。其他的观感位于com.sun.java包中,并且不是在每个Java实现中都提供。现在,鉴于版权的原因,Windows和Macintosh的观感包只与Windows和Macintosh版本的Java运行时环境一起发布。
第二种方式是动态地改变观感。这需要调用静态的UIManager.setLookAndFeel方法,并提供所想要的观感类名,然后再调用静态方法SwingUtilities.updateComponentTreeUI来刷新全部的组件集。这里需要向这个方法提供一个组件,并由此找到其他的所有组件。当UIManager.setLookAndFeel方法没有找到所希望的观感或在加载过程中出现错误时,将会抛出异常。
- javax.swing.UIManager 1.2
- static UIManager.LookAndFeelInfo[] getInstalledLookAndFeels()
获取一个用于描述已安装的观感实现的对象数组。
- static setLookAndFeel(String className)
利用给定的类名设置当前的观感。例如,javax.swing.plaf.MetalLookAndFeel。
- javax.swing.UIManager.LookAndFeelInfo 1.2
- String getName()
返回观感的显示名称。
- String getClassName()
返回观感实现类的名称。
8.1.5 适配器类
- 为了能够查看窗口是否被最大化,需要安装WindowStateListener。
- 每个含有多个方法的AWT监听器接口都配有一个适配器(adapter)类,这个类实现了接口中的所有方法,但每个方法没有做任何事情。这意味着适配器类自动满足了Java实现相关监听器接口的技术需求。可以通过扩展适配器类来指定对某些时间的响应动作,而不必实现接口中的每个方法。
- java.awt.event.WindowListener 1.1
- void windowOpened(WindowEvent e)
窗口打开后调用这个方法。
- void windowClosing(WindowEvent e)
在用户发出窗口管理器命令关闭窗口时调用这个方法。需要注意的是,仅当调用hide或dispose方法后窗口才能够关闭。
- void windowClosed(WindowEvent e)
窗口关闭后调用这个方法。
- void windowIconified(WindowEvent e)
窗口图标化后调用这个方法。
- void windowDeiconified(WindowEvent e)
窗口非图标化后调用这个方法。
- void windowActivated(WindowEvent e)
激活窗口后调用这个方法。只有框架或对话框可以被激活。通常,窗口管理器会对活动窗口进行修饰,比如,高亮度标题栏。
- void windowDeactivated(WindowEvent e)
窗口变为未激活状态后调用这个方法。
- void windowStateChanged(WindowEvent event)
窗口最大化、图标化或恢复为正常大小时调用这个方法。
- int getNewState()1.4
- int getOldState() 1.4
返回窗口状态改变事件中窗口的新、旧状态。返回的整型数值是下列数值之一:Frame.NORMAL、Frame.ICONIFIED、Frame.MAXIMIZED_HORIZ、Frame.MAXIMIZED_VERT、Frame.MAXIMIZED_BOTH。
8.2 动作
- 通常,激活一个命令可以有多种方式。用户可以通过菜单、击键或工具栏上的按钮选择特定的功能。在AWT事件模型中实现这些非常容易:将所有事件连接到同一个监听器上。
- Swing包提供了一种非常实用的机制来封装命令,并将它们连接到多个事件源,这就是Action接口。一个动作是一个封装下列内容的对象:
- 命令的说明(一个文本字符串和一个可选图标);
- 执行命令所需要的参数。
- Action接口扩展于ActionListener接口,因此,可以在任何需要ActionListener对象的地方使用Action对象。
- 预定义动作表名称
名称 |
值 |
NAME |
动作名称,显示在按钮和菜单上 |
SMALL_ICON |
存储小图标的地方;显示在按钮、菜单项或工具栏中 |
SHORT_DESCRIPTION |
图标的简要说明;显示在工具提示中 |
LONG_DESCRIPTION |
图标的详细说明;使用在在线帮助中。没有Swing组件使用这个值 |
MNEMONIC_KEY |
快捷键缩写;显示在菜单项中 |
ACCELERATOR_KEY |
存储加速击键的地方;Swing组件不使用这个值 |
ACTION_COMMAND_KEY |
历史遗留;仅在旧版本的registerKeyboardAction方法中使用 |
DEFAULT |
常用的综合属性;Swing组件不使用这个值 |
- 如果动作对象添加到菜单或工具栏上,它的名称和图标就会被自动地提取出来,并显示在菜单栏或工具栏项中。SHORT_DESCRIPTION值变成了工具提示。
- Action是一个接口,而不是一个类。有一个类实现了这个接口除actionPerformed方法之外的所有方法,它就是AbstractAction。这个类存储了所有名、值对。并管理着属性变更监听器。可以直接扩展AbstractAction类,并在扩展类中实现了actionPerformed方法。
- 每个JComponent有三个输入映射(input maps),每一个映射的KeyStore对象都与动作关联。三个输入映射对应着三个不同的条件。
输入映射表
标志 |
激活动作 |
WHEN_FOCUSED |
当这个组件拥有键盘焦点时 |
WHEN_ANCESTOR_OF_FOCUSED_COMPONENT |
当这个组件包含了拥有键盘焦点的组件时 |
WHEN_IN_FOCUSED_WINDOW |
当这个组件被包含在一个拥有键盘焦点组件的窗口中时 |
- 按键处理将按照下列顺序检查这些映射:
1)检查具有输入焦点组件的WHEN_FOCUSED映射。如果这个按键存在,将执行对应的动作。如果动作已启动,则停止处理。
2)从具有输入焦点的组件开始,检查其父组件的WHEN_ANCESTOR_OF_FOCUSED_COMPONENT映射。一旦找到按键对应的映射,就执行对应的动作。如果动作已启用,将停止处理。
3)查看具有输入焦点的窗口中的所有可视的和启用的组件,这个按键被注册到WHEN_IN_FOCUSED_WINDOW映射中。给这些组件(按照按键注册的顺序)一个执行对应动作的机会。一旦第一个启用的动作被执行,就停止处理。如果一个按键咋多个WHEN_IN+FOCUSED_WINDOW映射中出现,这部分处理就可能会出现问题。
- 可以使用getInputMap方法从组件中得到输入映射。
- InputMap不能直接将KeyStore对象映射到Actoin对象中。而是先映射到任意对象上,然后由ActionMap类实现将对象映射到动作上的第2个映射。这样很容易实现来自不同输入映射的按键共享一个动作的目的。
- 每个组件都可以有三个输入映射和一个动作映射。为了将他们组合起来,需要为动作命名。
- 用同一个动作响应按钮、菜单项或按键的方式:
1)实现一个扩展于AbstractAction类的类。多个相关的动作可以使用同一个类。
2)构造一个动作类的对象。
3)使用动作对象创建按钮或菜单项。构造器将从动作对象中读取标签文本和图标。
4)为了能够通过按键触发动作,必须额外地执行几步操作。首先定位顶层窗口组件,例如,包含所有其他组件的面板。
5)然后,得到顶层组件的WHEN_ANCESTOR_OF_FOCUS_COMPONENT输入映射。为需要的按键创建一个KeyStore对象。创建一个描述动作字符串这样的动作键对象。将(按键,动作键)对添加到输入映射中。
6)最后,得到顶层组件的动作映射。将(动作键,动作对象)添加到映射中。
- javax.swing.Action 1.2
- boolean isEnabled()
- void setEnabled(boolean b)
获得或设置这个动作额enabled属性。
- void putValue(String key,Object value)
将名/值对防止在动作对象内。
参数:key 用动作对象存储性能的名字。它可以是一个字符串,但预定义了几个名字。 value 与名字关联的对象。
- Object getValue(String key)
返回被存储的名/值对的值。
- javax.swing.KeyStore 1.2
- static KeyStore getKeyStroke(String description)
根据一个便于人们阅读的说明创建一个按键(由空格分割的字符串序列)。这个说明以0个或多个修饰符shift control strl meta alt altGraph开始,以由types和单个字符构成的字符串(例如:“typed a”)或者一个可选的事件说明符(pressed默认,或released)紧跟一个键码结束。以VK_前缀开始的键码应该对应一个KeyEvent常量,例如,“INSERT”对应KeyEvent.VK_INSERT。
- javax.swing.JComponent 1.2
- ActionMap getActionMap() 1.3
返回关联动作映射键(可以是任意的对象)和动作对象的映射。
- InputMap getInputMap(int flag) 1.3
获得将案件映射到动作键的输入映射。
参数:flag 触发动作的键盘焦点条件。
8.3 鼠标动作
- 当用户点击鼠标按钮时,将会调用三个监听器方法:鼠标第一次按下时调用mousePressed;鼠标被释放时调用mouseReleased;最后调用mouseClicked。如果只对最终的点击事件感兴趣,就可以忽略前两个方法。用MouseEvent类对象作为参数,调用getX和getY方法可以获得鼠标被按下时鼠标指针所在x和y坐标。要想区分单击、双击和三击(!),需要使用getClickCount方法。
- getModifiersEx方法能够准确地报告鼠标事件的鼠标按钮和键盘修饰符。
- 在Windows环境下,使用BUTTON3_DOWN_MASK检测鼠标右键(非主要的)的状态。
- java.awt.event.MouseEvent 1.1
- int getX()
- int getY()
- Point getPoint()
返回事件发生时,事件源组件左上角的坐标x(水平)和y(垂直),或点信息。
- int getClickCount()
返回与事件关联的鼠标连击次数(“连击”所指定的时间间隔与具体系统有关)。
- java.awt.event.InputEvent 1.1
- int getModifiersEx() 1.4
返回事件扩展的或“按下”(down)的修饰符。使用下面的掩码值检测返回值:BTTON1_DOWN_MASK、BUTTON2_DOWN_MASK、BUTTON3_DOWN_MASK、SHIFT_DOWN_MASK、CTRL_DOWN_MASK、ALT_DOWN_MASK、ALT_GRAPH_DOWN_MASK、META_DOWN_MASK。
- static String getModifiersExText(int modifiers) 1.4
返回用给定标志集描述的扩展或“按下”(down)的修饰符字符串,例如“Shift+Button1”。
- java.awt.Toolkit 1.0
- public Cursor createCustomCursor(Image image,Point hotSpot,String name) 1.2
创建一个新的定制光标对象。
参数:image 光标活动时显示的图像。hotSpot 光标热点(箭头的顶点或十字中心)。name 光标的描述,用来支持特殊的访问环境。
- java.awt.Component 1.0
- public void setCursor(Cursor cursor) 1.1
用光标图像设置给定光标。
8.4 AWT事件继承层次
- Java事件处理采用的是面向对象方法,所有的事件都是由java.util包中的EventObject类扩展而来的。EventObject类有一个子类AWTEvent,它是所有AWT事件类的父类。有些Swing组件将生成其他事件类型的事件对象;它们都直接扩展于EventObject,而不是AWTEvent。事件对象封装了事件源与监听器彼此通信的事件信息。在必要的时候,可以对传递给监听器对象的事件对象进行分析。
- AWT将事件分为低级(low-level)事件和语义(semantic)事件。语义事件是表示用户动作的事件,因此,ActionEvent是一种语义事件。低级事件是形成那些事件的事件。
- java.awt.event包中最常用的语义事件类:
- ActionEvent(对应按钮点击、菜单选择、选择列表项或文本框中ENTER);
- AdjustmentEvent(用户调节滚动条);
- ItemEvent(用户从复选框或列表框中选择一项)。
- 常用的5个低级事件类是:
- KeyEvent(一个键被按下或释放);
- MouseEvent(鼠标键被按下、释放、移动或拖动);
- MouseWheelEvent(鼠标滚轮被转动);
- FocusEvent(某个组件获得焦点或失去焦点)。
- WindowEvent(窗口状态被改变)。
下列接口将监听这些事件:ActionListener、AdjustmentListener、FocusListener、ItemListener、KeyListener、MouseListener、MouseMotionListener、MouseWheelListener、WindowListener、WindowFocusListener、WindowStateListener。
- 常用的适配器类:FocusAdapter、KeyAdapter、MouseAdapter、MouseMotionAdapter、WindowAdapter。
- 事件处理总结
接口 |
方法 |
参数/访问方法 |
事件源 |
ActionListener |
actionPerformed |
ActionEvent(getActionCommand、getModifiers) |
AbstractButton、JComboBox、JTextField、Timer |
AdjustmentListener |
adjustmentValueChanged |
AdjustmentEvent(getAdjustable、getAdjustmentType、getValue) |
JScrollbar |
ItemListener |
itemStateChanged |
ItemEvent(getItem、getItemSelectale、getStateChange) |
AbstractButton、JComboBox |
FocusListener |
FocusGained、FocusLayout |
FocusEvent(isTemporary) |
Component |
KeyListener |
keyPressed、keyReleased、KeyTyped |
KeyEvent(getKeyChar、getKeyCode、getKeyModifiersText、getKeyText、isActionKey) |
Component |
MouseListener |
mousePressed、mouseReleased、mouseEntered、mouseExited、mouseClicked |
MouseEvent(getClickCount、getX、getY、getPoint、translatePoint) |
Component |
MouseMotionListener |
mouseDragged、mouseMoved |
MouseEvent |
Component |
MouseWheelListener |
mouseWheelMoved |
MouseWheelEvent(getWheelRotation、getScrollAmount) |
Component |
WindowListener |
windowClosing、windowOpened、windowIconified、windowDeiconified、windowClosed、windowActivated、windowDeactivated |
WindowEvent(getWindow) |
Window |
WindowFocusListener |
windowGainedFocus、windowLostFocus |
WindowEvent(getOppsiteWindow) |
Window |
WindowStateListener |
windowStateChanged |
WindowEvent(getOldState、getNewState) |
Winow |