< prev index next >
src/java.desktop/share/classes/java/awt/event/WindowEvent.java
Print this page
*** 34,49 ****
* 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
* transferred into or out of the Window.
* <P>
! * The event is passed to every <code>WindowListener</code>
! * or <code>WindowAdapter</code> object which registered to receive such
! * events using the window's <code>addWindowListener</code> method.
! * (<code>WindowAdapter</code> objects implement the
! * <code>WindowListener</code> interface.) Each such listener object
! * gets this <code>WindowEvent</code> when the event occurs.
* <p>
* An unspecified behavior will be caused if the {@code id} parameter
* of any particular {@code WindowEvent} instance is not
* in the range from {@code WINDOW_FIRST} to {@code WINDOW_LAST}.
*
--- 34,49 ----
* 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
* transferred into or out of the Window.
* <P>
! * The event is passed to every {@code WindowListener}
! * or {@code WindowAdapter} object which registered to receive such
! * events using the window's {@code addWindowListener} method.
! * ({@code WindowAdapter} objects implement the
! * {@code WindowListener} interface.) Each such listener object
! * gets this {@code WindowEvent} when the event occurs.
* <p>
* An unspecified behavior will be caused if the {@code id} parameter
* of any particular {@code WindowEvent} instance is not
* in the range from {@code WINDOW_FIRST} to {@code WINDOW_LAST}.
*
*** 174,200 ****
*/
private static final long serialVersionUID = -1567959133147912127L;
/**
! * Constructs a <code>WindowEvent</code> object.
* <p>This method throws an
! * <code>IllegalArgumentException</code> if <code>source</code>
! * is <code>null</code>.
*
! * @param source The <code>Window</code> object
* that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link WindowEvent}
* @param opposite The other window involved in the focus or activation
! * change, or <code>null</code>
* @param oldState Previous state of the window for window state change event.
* See {@code #getOldState()} for allowable values
* @param newState New state of the window for window state change event.
* See {@code #getNewState()} for allowable values
! * @throws IllegalArgumentException if <code>source</code> is null
* @see #getWindow()
* @see #getID()
* @see #getOppositeWindow()
* @see #getOldState()
* @see #getNewState()
--- 174,200 ----
*/
private static final long serialVersionUID = -1567959133147912127L;
/**
! * Constructs a {@code WindowEvent} object.
* <p>This method throws an
! * {@code IllegalArgumentException} if {@code source}
! * is {@code null}.
*
! * @param source The {@code Window} object
* that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link WindowEvent}
* @param opposite The other window involved in the focus or activation
! * change, or {@code null}
* @param oldState Previous state of the window for window state change event.
* See {@code #getOldState()} for allowable values
* @param newState New state of the window for window state change event.
* See {@code #getNewState()} for allowable values
! * @throws IllegalArgumentException if {@code source} is null
* @see #getWindow()
* @see #getID()
* @see #getOppositeWindow()
* @see #getOldState()
* @see #getNewState()
*** 208,266 ****
this.oldState = oldState;
this.newState = newState;
}
/**
! * Constructs a <code>WindowEvent</code> object with the
! * specified opposite <code>Window</code>. The opposite
! * <code>Window</code> is the other <code>Window</code>
* involved in this focus or activation change.
! * For a <code>WINDOW_ACTIVATED</code> or
! * <code>WINDOW_GAINED_FOCUS</code> event, this is the
! * <code>Window</code> that lost activation or focus.
! * For a <code>WINDOW_DEACTIVATED</code> or
! * <code>WINDOW_LOST_FOCUS</code> event, this is the
! * <code>Window</code> 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
! * <code>Window</code>, then the opposite Window is <code>null</code>.
* <p>This method throws an
! * <code>IllegalArgumentException</code> if <code>source</code>
! * is <code>null</code>.
*
! * @param source The <code>Window</code> object that
* originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link WindowEvent}.
* It is expected that this constructor will not
* be used for other then
* {@code WINDOW_ACTIVATED},{@code WINDOW_DEACTIVATED},
* {@code WINDOW_GAINED_FOCUS}, or {@code WINDOW_LOST_FOCUS}.
* {@code WindowEvent} types,
! * because the opposite <code>Window</code> of other event types
* will always be {@code null}.
! * @param opposite The other <code>Window</code> involved in the
! * focus or activation change, or <code>null</code>
! * @throws IllegalArgumentException if <code>source</code> is null
* @see #getWindow()
* @see #getID()
* @see #getOppositeWindow()
* @since 1.4
*/
public WindowEvent(Window source, int id, Window opposite) {
this(source, id, opposite, 0, 0);
}
/**
! * Constructs a <code>WindowEvent</code> object with the specified
* previous and new window states.
* <p>This method throws an
! * <code>IllegalArgumentException</code> if <code>source</code>
! * is <code>null</code>.
*
! * @param source The <code>Window</code> object
* that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link WindowEvent}.
* It is expected that this constructor will not
--- 208,266 ----
this.oldState = oldState;
this.newState = newState;
}
/**
! * Constructs a {@code WindowEvent} object with the
! * specified opposite {@code Window}. The opposite
! * {@code Window} is the other {@code Window}
* involved in this focus or activation change.
! * For a {@code WINDOW_ACTIVATED} or
! * {@code WINDOW_GAINED_FOCUS} event, this is the
! * {@code Window} that lost activation or focus.
! * For a {@code WINDOW_DEACTIVATED} or
! * {@code WINDOW_LOST_FOCUS} event, this is the
! * {@code 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
! * {@code Window}, then the opposite Window is {@code null}.
* <p>This method throws an
! * {@code IllegalArgumentException} if {@code source}
! * is {@code null}.
*
! * @param source The {@code Window} object that
* originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link WindowEvent}.
* It is expected that this constructor will not
* be used for other then
* {@code WINDOW_ACTIVATED},{@code WINDOW_DEACTIVATED},
* {@code WINDOW_GAINED_FOCUS}, or {@code WINDOW_LOST_FOCUS}.
* {@code WindowEvent} types,
! * because the opposite {@code Window} of other event types
* will always be {@code null}.
! * @param opposite The other {@code Window} involved in the
! * focus or activation change, or {@code null}
! * @throws IllegalArgumentException if {@code source} is null
* @see #getWindow()
* @see #getID()
* @see #getOppositeWindow()
* @since 1.4
*/
public WindowEvent(Window source, int id, Window opposite) {
this(source, id, opposite, 0, 0);
}
/**
! * Constructs a {@code WindowEvent} object with the specified
* previous and new window states.
* <p>This method throws an
! * {@code IllegalArgumentException} if {@code source}
! * is {@code null}.
*
! * @param source The {@code Window} object
* that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link WindowEvent}.
* It is expected that this constructor will not
*** 271,281 ****
* states are meaningless for other event types.
* @param oldState An integer representing the previous window state.
* See {@code #getOldState()} for allowable values
* @param newState An integer representing the new window state.
* See {@code #getNewState()} for allowable values
! * @throws IllegalArgumentException if <code>source</code> is null
* @see #getWindow()
* @see #getID()
* @see #getOldState()
* @see #getNewState()
* @since 1.4
--- 271,281 ----
* states are meaningless for other event types.
* @param oldState An integer representing the previous window state.
* See {@code #getOldState()} for allowable values
* @param newState An integer representing the new window state.
* See {@code #getNewState()} for allowable values
! * @throws IllegalArgumentException if {@code source} is null
* @see #getWindow()
* @see #getID()
* @see #getOldState()
* @see #getNewState()
* @since 1.4
*** 283,302 ****
public WindowEvent(Window source, int id, int oldState, int newState) {
this(source, id, null, oldState, newState);
}
/**
! * Constructs a <code>WindowEvent</code> object.
* <p>This method throws an
! * <code>IllegalArgumentException</code> if <code>source</code>
! * is <code>null</code>.
*
! * @param source The <code>Window</code> object that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link WindowEvent}.
! * @throws IllegalArgumentException if <code>source</code> is null
* @see #getWindow()
* @see #getID()
*/
public WindowEvent(Window source, int id) {
this(source, id, null, 0, 0);
--- 283,302 ----
public WindowEvent(Window source, int id, int oldState, int newState) {
this(source, id, null, oldState, newState);
}
/**
! * Constructs a {@code WindowEvent} object.
* <p>This method throws an
! * {@code IllegalArgumentException} if {@code source}
! * is {@code null}.
*
! * @param source The {@code Window} object that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link WindowEvent}.
! * @throws IllegalArgumentException if {@code source} is null
* @see #getWindow()
* @see #getID()
*/
public WindowEvent(Window source, int id) {
this(source, id, null, 0, 0);
*** 334,355 ****
? opposite
: null;
}
/**
! * For <code>WINDOW_STATE_CHANGED</code> events returns the
* previous state of the window. The state is
* represented as a bitwise mask.
* <ul>
! * <li><code>NORMAL</code>
* <br>Indicates that no state bits are set.
! * <li><code>ICONIFIED</code>
! * <li><code>MAXIMIZED_HORIZ</code>
! * <li><code>MAXIMIZED_VERT</code>
! * <li><code>MAXIMIZED_BOTH</code>
! * <br>Concatenates <code>MAXIMIZED_HORIZ</code>
! * and <code>MAXIMIZED_VERT</code>.
* </ul>
*
* @return a bitwise mask of the previous window state
* @see java.awt.Frame#getExtendedState()
* @since 1.4
--- 334,355 ----
? opposite
: null;
}
/**
! * For {@code WINDOW_STATE_CHANGED} events returns the
* previous state of the window. The state is
* represented as a bitwise mask.
* <ul>
! * <li>{@code NORMAL}
* <br>Indicates that no state bits are set.
! * <li>{@code ICONIFIED}
! * <li>{@code MAXIMIZED_HORIZ}
! * <li>{@code MAXIMIZED_VERT}
! * <li>{@code MAXIMIZED_BOTH}
! * <br>Concatenates {@code MAXIMIZED_HORIZ}
! * and {@code MAXIMIZED_VERT}.
* </ul>
*
* @return a bitwise mask of the previous window state
* @see java.awt.Frame#getExtendedState()
* @since 1.4
*** 357,378 ****
public int getOldState() {
return oldState;
}
/**
! * For <code>WINDOW_STATE_CHANGED</code> events returns the
* new state of the window. The state is
* represented as a bitwise mask.
* <ul>
! * <li><code>NORMAL</code>
* <br>Indicates that no state bits are set.
! * <li><code>ICONIFIED</code>
! * <li><code>MAXIMIZED_HORIZ</code>
! * <li><code>MAXIMIZED_VERT</code>
! * <li><code>MAXIMIZED_BOTH</code>
! * <br>Concatenates <code>MAXIMIZED_HORIZ</code>
! * and <code>MAXIMIZED_VERT</code>.
* </ul>
*
* @return a bitwise mask of the new window state
* @see java.awt.Frame#getExtendedState()
* @since 1.4
--- 357,378 ----
public int getOldState() {
return oldState;
}
/**
! * For {@code WINDOW_STATE_CHANGED} events returns the
* new state of the window. The state is
* represented as a bitwise mask.
* <ul>
! * <li>{@code NORMAL}
* <br>Indicates that no state bits are set.
! * <li>{@code ICONIFIED}
! * <li>{@code MAXIMIZED_HORIZ}
! * <li>{@code MAXIMIZED_VERT}
! * <li>{@code MAXIMIZED_BOTH}
! * <br>Concatenates {@code MAXIMIZED_HORIZ}
! * and {@code MAXIMIZED_VERT}.
* </ul>
*
* @return a bitwise mask of the new window state
* @see java.awt.Frame#getExtendedState()
* @since 1.4
< prev index next >