< prev index next >

src/java.desktop/share/classes/java/awt/Window.java

Print this page




 117  * physical screen of the specified {@code GraphicsConfiguration}.
 118  *
 119  * <pre>
 120  *      Window w = new Window(Window owner, GraphicsConfiguration gc);
 121  *      Rectangle bounds = gc.getBounds();
 122  *      w.setLocation(10 + bounds.x, 10 + bounds.y);
 123  * </pre>
 124  *
 125  * <p>
 126  * Note: the location and size of top-level windows (including
 127  * {@code Window}s, {@code Frame}s, and {@code Dialog}s)
 128  * are under the control of the desktop's window management system.
 129  * Calls to {@code setLocation}, {@code setSize}, and
 130  * {@code setBounds} are requests (not directives) which are
 131  * forwarded to the window management system.  Every effort will be
 132  * made to honor such requests.  However, in some cases the window
 133  * management system may ignore such requests, or modify the requested
 134  * geometry in order to place and size the {@code Window} in a way
 135  * that more closely matches the desktop settings.
 136  * <p>







 137  * Due to the asynchronous nature of native event handling, the results
 138  * returned by {@code getBounds}, {@code getLocation},
 139  * {@code getLocationOnScreen}, and {@code getSize} might not
 140  * reflect the actual geometry of the Window on screen until the last
 141  * request has been processed.  During the processing of subsequent
 142  * requests these values might change accordingly while the window
 143  * management system fulfills the requests.
 144  * <p>
 145  * An application may set the size and location of an invisible
 146  * {@code Window} arbitrarily, but the window management system may
 147  * subsequently change its size and/or location when the
 148  * {@code Window} is made visible. One or more {@code ComponentEvent}s
 149  * will be generated to indicate the new geometry.
 150  * <p>
 151  * Windows are capable of generating the following WindowEvents:
 152  * WindowOpened, WindowClosed, WindowGainedFocus, WindowLostFocus.
 153  *
 154  * @author      Sami Shaio
 155  * @author      Arthur van Hoff
 156  * @see WindowEvent




 117  * physical screen of the specified {@code GraphicsConfiguration}.
 118  *
 119  * <pre>
 120  *      Window w = new Window(Window owner, GraphicsConfiguration gc);
 121  *      Rectangle bounds = gc.getBounds();
 122  *      w.setLocation(10 + bounds.x, 10 + bounds.y);
 123  * </pre>
 124  *
 125  * <p>
 126  * Note: the location and size of top-level windows (including
 127  * {@code Window}s, {@code Frame}s, and {@code Dialog}s)
 128  * are under the control of the desktop's window management system.
 129  * Calls to {@code setLocation}, {@code setSize}, and
 130  * {@code setBounds} are requests (not directives) which are
 131  * forwarded to the window management system.  Every effort will be
 132  * made to honor such requests.  However, in some cases the window
 133  * management system may ignore such requests, or modify the requested
 134  * geometry in order to place and size the {@code Window} in a way
 135  * that more closely matches the desktop settings.
 136  * <p>
 137  * The visual appearance and behavior of top-level windows (including
 138  * normal/shaped/translucent/undecorated {@code Window}s, {@code Frame}s,
 139  * {@code Dialog}s) are under the control of the desktop's window management
 140  * system. The visual effects as shadows, motion effects, animations,
 141  * and others may not be controlled by the applications but work according to
 142  * the desktop settings.
 143  * <p>
 144  * Due to the asynchronous nature of native event handling, the results
 145  * returned by {@code getBounds}, {@code getLocation},
 146  * {@code getLocationOnScreen}, and {@code getSize} might not
 147  * reflect the actual geometry of the Window on screen until the last
 148  * request has been processed.  During the processing of subsequent
 149  * requests these values might change accordingly while the window
 150  * management system fulfills the requests.
 151  * <p>
 152  * An application may set the size and location of an invisible
 153  * {@code Window} arbitrarily, but the window management system may
 154  * subsequently change its size and/or location when the
 155  * {@code Window} is made visible. One or more {@code ComponentEvent}s
 156  * will be generated to indicate the new geometry.
 157  * <p>
 158  * Windows are capable of generating the following WindowEvents:
 159  * WindowOpened, WindowClosed, WindowGainedFocus, WindowLostFocus.
 160  *
 161  * @author      Sami Shaio
 162  * @author      Arthur van Hoff
 163  * @see WindowEvent


< prev index next >