|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.util.EventObject java.awt.AWTEvent java.awt.event.ComponentEvent java.awt.event.WindowEvent
public class WindowEvent
A low-level event that indicates that a window has changed its status. This low-level event is generated by a Window object when it is opened, closed, activated, deactivated, iconified, or deiconified, or when focus is transfered into or out of the Window.
The event is passed to every WindowListener
or WindowAdapter
object which registered to receive such
events using the window's addWindowListener
method.
(WindowAdapter
objects implement the
WindowListener
interface.) Each such listener object
gets this WindowEvent
when the event occurs.
WindowAdapter
,
WindowListener
,
Tutorial: Writing a Window Listener,
Serialized FormField Summary | |
---|---|
static int |
WINDOW_ACTIVATED
The window-activated event type. |
static int |
WINDOW_CLOSED
The window closed event. |
static int |
WINDOW_CLOSING
The "window is closing" event. |
static int |
WINDOW_DEACTIVATED
The window-deactivated event type. |
static int |
WINDOW_DEICONIFIED
The window deiconified event type. |
static int |
WINDOW_FIRST
The first number in the range of ids used for window events. |
static int |
WINDOW_GAINED_FOCUS
The window-gained-focus event type. |
static int |
WINDOW_ICONIFIED
The window iconified event. |
static int |
WINDOW_LAST
The last number in the range of ids used for window events. |
static int |
WINDOW_LOST_FOCUS
The window-lost-focus event type. |
static int |
WINDOW_OPENED
The window opened event. |
static int |
WINDOW_STATE_CHANGED
The window-state-changed event type. |
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.util.EventObject |
---|
source |
Constructor Summary | |
---|---|
WindowEvent(Window source,
int id)
Constructs a WindowEvent object. |
|
WindowEvent(Window source,
int id,
int oldState,
int newState)
Constructs a WindowEvent object with the specified
previous and new window states. |
|
WindowEvent(Window source,
int id,
Window opposite)
Constructs a WindowEvent object with the
specified opposite Window . |
|
WindowEvent(Window source,
int id,
Window opposite,
int oldState,
int newState)
Constructs a WindowEvent object. |
Method Summary | |
---|---|
int |
getNewState()
For WINDOW_STATE_CHANGED events returns the
new state of the window. |
int |
getOldState()
For WINDOW_STATE_CHANGED events returns the
previous state of the window. |
Window |
getOppositeWindow()
Returns the other Window involved in this focus or activation change. |
Window |
getWindow()
Returns the originator of the event. |
String |
paramString()
Returns a parameter string identifying this event. |
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 |
---|
public static final int WINDOW_FIRST
public static final int WINDOW_OPENED
public static final int WINDOW_CLOSING
public static final int WINDOW_CLOSED
public static final int WINDOW_ICONIFIED
Frame.setIconImage(java.awt.Image)
,
Constant Field Valuespublic static final int WINDOW_DEICONIFIED
public static final int WINDOW_ACTIVATED
public static final int WINDOW_DEACTIVATED
public static final int WINDOW_GAINED_FOCUS
public static final int WINDOW_LOST_FOCUS
public static final int WINDOW_STATE_CHANGED
public static final int WINDOW_LAST
Constructor Detail |
---|
public WindowEvent(Window source, int id, Window opposite, int oldState, int newState)
WindowEvent
object.
Note that passing in an invalid id
results in
unspecified behavior. This method throws an
IllegalArgumentException
if source
is null
.
source
- the Window
object
that originated the eventid
- an integer indicating the type of event.opposite
- the other window involved in the focus or activation
change, or null
oldState
- previous state of the window for window state
change eventnewState
- new state of the window for window state change event
IllegalArgumentException
- if source
is nullpublic WindowEvent(Window source, int id, Window opposite)
WindowEvent
object with the
specified opposite Window
. The opposite
Window
is the other Window
involved in this focus or activation change.
For a WINDOW_ACTIVATED
or
WINDOW_GAINED_FOCUS
event, this is the
Window
that lost activation or focus.
For a WINDOW_DEACTIVATED
or
WINDOW_LOST_FOCUS
event, this is the
Window
that gained activation or focus.
If this focus change occurs with a native application, with a
Java application in a different VM, or with no other
Window
, then the opposite Window is null
.
Note that passing in an invalid id
results in
unspecified behavior. This method throws an
IllegalArgumentException
if source
is null
.
source
- the Window
object that
originated the eventid
- WINDOW_ACTIVATED
,
WINDOW_DEACTIVATED
,
WINDOW_GAINED_FOCUS
,
or WINDOW_LOST_FOCUS
. It is
expected that this constructor will not be used for
other WindowEvent
types because the
opposite Window
of such events
will always be null
opposite
- the other Window
involved in the
focus or activation change, or null
IllegalArgumentException
- if source
is nullpublic WindowEvent(Window source, int id, int oldState, int newState)
WindowEvent
object with the specified
previous and new window states.
Note that passing in an invalid id
results in
unspecified behavior. This method throws an
IllegalArgumentException
if source
is null
.
source
- the Window
object
that originated the eventid
- WINDOW_STATE_CHANGED
event type.
It is expected that this constructor will not
be used for other WindowEvent
types, because the previous and new window
states are meaningless for other event types.oldState
- an integer representing the previous window statenewState
- an integer representing the new window state
IllegalArgumentException
- if source
is nullpublic WindowEvent(Window source, int id)
WindowEvent
object.
Note that passing in an invalid id
results in
unspecified behavior. This method throws an
IllegalArgumentException
if source
is null
.
source
- the Window
object that originated the eventid
- an integer indicating the type of event
IllegalArgumentException
- if source
is nullMethod Detail |
---|
public Window getWindow()
public Window getOppositeWindow()
public int getOldState()
WINDOW_STATE_CHANGED
events returns the
previous state of the window. The state is
represented as a bitwise mask.
NORMAL
ICONIFIED
MAXIMIZED_HORIZ
MAXIMIZED_VERT
MAXIMIZED_BOTH
MAXIMIZED_HORIZ
and MAXIMIZED_VERT
.
Frame.getExtendedState()
public int getNewState()
WINDOW_STATE_CHANGED
events returns the
new state of the window. The state is
represented as a bitwise mask.
NORMAL
ICONIFIED
MAXIMIZED_HORIZ
MAXIMIZED_VERT
MAXIMIZED_BOTH
MAXIMIZED_HORIZ
and MAXIMIZED_VERT
.
Frame.getExtendedState()
public String paramString()
paramString
in class ComponentEvent
|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.