java.awt.event

Class FocusEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.ComponentEvent

java.awt.event.FocusEvent

All Implemented Interfaces:

Serializable

public class FocusEvent
extends ComponentEvent

一个低级别的事件，这表明一个组件已经获得或失去了输入焦点。这种低层次的事件是由组件产生（如文本框）。事件传递到每一个 FocusListener或 FocusAdapter对象注册到使用组件的 addFocusListener方法接收这样的事件。（ FocusAdapter对象实现了 FocusListener接口。）每个侦听器对象被这 FocusEvent事件发生时。

有两个层次的焦点事件：永久性和临时性。永久改变焦点事件发生时的重点是直接从一个组件到另一个，如通过电话requestfocus()或用户使用Tab键遍历组件。临时改变焦点事件发生时的重点是暂时失去了一部分作为另一个操作的间接结果，如窗口失活或滚动条拖动。在这种情况下，原来的焦点状态会自动恢复一旦操作完成，或者，对窗口失活的情况下，当窗口被激活。永久和临时的焦点事件使用的是focus_gained和focus_lost事件ID交付；水平可以在事件中使用istemporary()方法区分。

未指定的行为将如果任何特定的FocusEvent实例的id参数不在FOCUS_FIRST到FOCUS_LAST范围造成的。

从以下版本开始：

一点一

另请参见：

FocusAdapter， FocusListener， Tutorial: Writing a Focus Listener， Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	FOCUS_FIRST 用于焦点事件的入侵检测范围的第一个数字。
static int	FOCUS_GAINED 此事件指示该组件现在是焦点所有者。
static int	FOCUS_LAST 用于焦点事件的入侵检测范围的最后一个数字。
static int	FOCUS_LOST 此事件指示该组件不再是焦点所有者。

Fields inherited from class java.awt.event.ComponentEvent

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

Fields inherited from class java.awt.AWTEvent

ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor and Description
FocusEvent(Component source, int id) 构建了一个 FocusEvent对象确定为重点的永久性改变。
FocusEvent(Component source, int id, boolean temporary) 构建了一个 FocusEvent对象并确定是否改变是暂时的。
FocusEvent(Component source, int id, boolean temporary, Component opposite) 构建一个与指定的临时状态，相反 Component FocusEvent对象。

方法摘要

Modifier and Type	Method and Description
Component	getOppositeComponent() 返回在这个焦点变化中所涉及的其他组件。
boolean	isTemporary() 标识临时或永久性的焦点更改事件。
String	paramString() 返回标识此事件的参数字符串。

Methods inherited from class java.awt.event.ComponentEvent

getComponent

Methods inherited from class java.awt.AWTEvent

consume, getID, isConsumed, setSource, toString

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

FOCUS_FIRST

public static final int FOCUS_FIRST

用于焦点事件的入侵检测范围的第一个数字。

另请参见：

Constant Field Values

FOCUS_LAST

public static final int FOCUS_LAST

用于焦点事件的入侵检测范围的最后一个数字。

另请参见：

Constant Field Values

FOCUS_GAINED

public static final int FOCUS_GAINED

此事件指示该组件现在是焦点所有者。

另请参见：

Constant Field Values

FOCUS_LOST

public static final int FOCUS_LOST

此事件指示该组件不再是焦点所有者。

另请参见：

Constant Field Values

Constructor Detail

FocusEvent

public FocusEvent(Component source,
                  int id,
                  boolean temporary,
                  Component opposite)

构建一个与指定的临时状态，相反 Component FocusEvent对象。相反 Component参与这个焦点改变其他 Component。一 FOCUS_GAINED事件，这是失去焦点的 Component。一 FOCUS_LOST事件，这是获得焦点的 Component。如果焦点发生变化与本机应用程序，在不同的虚拟机的一个java应用程序，或没有其他 Component，那么相反的 Component是 null。

该方法抛出一个IllegalArgumentException如果source是null。

参数

source - Component起源事件

id -整数表示事件的类型。在允许值的信息，看到 FocusEvent类的描述

temporary -等于 true如果焦点的变化是暂时的； false否则

opposite -参与焦点改变其他组件，或 null

异常

IllegalArgumentException -如果 source等于 null

从以下版本开始：

一点四

另请参见：

EventObject.getSource()， AWTEvent.getID()， isTemporary()， getOppositeComponent()

FocusEvent

public FocusEvent(Component source,
                  int id,
                  boolean temporary)

构建了一个 FocusEvent对象并确定是否改变是暂时的。

该方法抛出一个IllegalArgumentException如果source是null。

参数

source - Component起源事件

id -整数表示事件的类型。在允许值的信息，看到 FocusEvent类的描述

temporary -等于 true如果焦点的变化是暂时的； false否则

异常

IllegalArgumentException -如果 source等于 null

另请参见：

EventObject.getSource()， AWTEvent.getID()， isTemporary()

FocusEvent

public FocusEvent(Component source,
                  int id)

构建了一个 FocusEvent对象确定为重点的永久性改变。

该方法抛出一个IllegalArgumentException如果source是null。

参数

source - Component起源事件

id -整数表示事件的类型。在允许值的信息，看到 FocusEvent类的描述

异常

IllegalArgumentException -如果 source等于 null

另请参见：

EventObject.getSource()， AWTEvent.getID()

方法详细信息

isTemporary

public boolean isTemporary()

标识临时或永久性的焦点更改事件。

结果

true如果焦点的变化是暂时的； false否则

getOppositeComponent

public Component getOppositeComponent()

返回在这个焦点变化中所涉及的其他组件。一focus_gained事件，这是失去焦点的组件。一focus_lost事件，这是获得焦点的组件。如果焦点发生变化与本机应用程序，在不同的虚拟机或上下文的一个java应用程序，或任何其他组件，则返回null。

结果

在焦点更改中的其他组件或空

从以下版本开始：

一点四

paramString

public String paramString()

返回标识此事件的参数字符串。此方法用于事件日志记录和调试是有用的。

重写：

paramString 方法重写，继承类 ComponentEvent

结果

识别事件及其属性的字符串