jdk/src/share/classes/java/awt/event/WindowListener.java
changeset 22254 8550495a4d78
parent 20455 f6f9a0c2796b
equal deleted inserted replaced
22173:f130ca87de66 22254:8550495a4d78
     1 /*
     1 /*
     2  * Copyright (c) 1996, 2003, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     7  * published by the Free Software Foundation.  Oracle designates this
    49  * @since 1.1
    49  * @since 1.1
    50  */
    50  */
    51 public interface WindowListener extends EventListener {
    51 public interface WindowListener extends EventListener {
    52     /**
    52     /**
    53      * Invoked the first time a window is made visible.
    53      * Invoked the first time a window is made visible.
       
    54      * @param e the event to be processed
    54      */
    55      */
    55     public void windowOpened(WindowEvent e);
    56     public void windowOpened(WindowEvent e);
    56 
    57 
    57     /**
    58     /**
    58      * Invoked when the user attempts to close the window
    59      * Invoked when the user attempts to close the window
    59      * from the window's system menu.
    60      * from the window's system menu.
       
    61      * @param e the event to be processed
    60      */
    62      */
    61     public void windowClosing(WindowEvent e);
    63     public void windowClosing(WindowEvent e);
    62 
    64 
    63     /**
    65     /**
    64      * Invoked when a window has been closed as the result
    66      * Invoked when a window has been closed as the result
    65      * of calling dispose on the window.
    67      * of calling dispose on the window.
       
    68      * @param e the event to be processed
    66      */
    69      */
    67     public void windowClosed(WindowEvent e);
    70     public void windowClosed(WindowEvent e);
    68 
    71 
    69     /**
    72     /**
    70      * Invoked when a window is changed from a normal to a
    73      * Invoked when a window is changed from a normal to a
    71      * minimized state. For many platforms, a minimized window
    74      * minimized state. For many platforms, a minimized window
    72      * is displayed as the icon specified in the window's
    75      * is displayed as the icon specified in the window's
    73      * iconImage property.
    76      * iconImage property.
       
    77      * @param e the event to be processed
    74      * @see java.awt.Frame#setIconImage
    78      * @see java.awt.Frame#setIconImage
    75      */
    79      */
    76     public void windowIconified(WindowEvent e);
    80     public void windowIconified(WindowEvent e);
    77 
    81 
    78     /**
    82     /**
    79      * Invoked when a window is changed from a minimized
    83      * Invoked when a window is changed from a minimized
    80      * to a normal state.
    84      * to a normal state.
       
    85      * @param e the event to be processed
    81      */
    86      */
    82     public void windowDeiconified(WindowEvent e);
    87     public void windowDeiconified(WindowEvent e);
    83 
    88 
    84     /**
    89     /**
    85      * Invoked when the Window is set to be the active Window. Only a Frame or
    90      * Invoked when the Window is set to be the active Window. Only a Frame or
    86      * a Dialog can be the active Window. The native windowing system may
    91      * a Dialog can be the active Window. The native windowing system may
    87      * denote the active Window or its children with special decorations, such
    92      * denote the active Window or its children with special decorations, such
    88      * as a highlighted title bar. The active Window is always either the
    93      * as a highlighted title bar. The active Window is always either the
    89      * focused Window, or the first Frame or Dialog that is an owner of the
    94      * focused Window, or the first Frame or Dialog that is an owner of the
    90      * focused Window.
    95      * focused Window.
       
    96      * @param e the event to be processed
    91      */
    97      */
    92     public void windowActivated(WindowEvent e);
    98     public void windowActivated(WindowEvent e);
    93 
    99 
    94     /**
   100     /**
    95      * Invoked when a Window is no longer the active Window. Only a Frame or a
   101      * Invoked when a Window is no longer the active Window. Only a Frame or a
    96      * Dialog can be the active Window. The native windowing system may denote
   102      * Dialog can be the active Window. The native windowing system may denote
    97      * the active Window or its children with special decorations, such as a
   103      * the active Window or its children with special decorations, such as a
    98      * highlighted title bar. The active Window is always either the focused
   104      * highlighted title bar. The active Window is always either the focused
    99      * Window, or the first Frame or Dialog that is an owner of the focused
   105      * Window, or the first Frame or Dialog that is an owner of the focused
   100      * Window.
   106      * Window.
       
   107      * @param e the event to be processed
   101      */
   108      */
   102     public void windowDeactivated(WindowEvent e);
   109     public void windowDeactivated(WindowEvent e);
   103 }
   110 }