< prev index next >

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

Print this page




  72  * to particular native toolkit implementations.
  73  * <p>
  74  * Many GUI events may be delivered to user
  75  * asynchronously, if the opposite is not specified explicitly.
  76  * As well as
  77  * many GUI operations may be performed asynchronously.
  78  * This fact means that if the state of a component is set, and then
  79  * the state immediately queried, the returned value may not yet
  80  * reflect the requested change.  This behavior includes, but is not
  81  * limited to:
  82  * <ul>
  83  * <li>Scrolling to a specified position.
  84  * <br>For example, calling {@code ScrollPane.setScrollPosition}
  85  *     and then {@code getScrollPosition} may return an incorrect
  86  *     value if the original request has not yet been processed.
  87  *
  88  * <li>Moving the focus from one component to another.
  89  * <br>For more information, see
  90  * <a href="http://docs.oracle.com/javase/tutorial/uiswing/misc/focus.html#transferTiming">Timing
  91  * Focus Transfers</a>, a section in
  92  * <a href="http://java.sun.com/docs/books/tutorial/uiswing/">The Swing
  93  * Tutorial</a>.
  94  *
  95  * <li>Making a top-level container visible.
  96  * <br>Calling {@code setVisible(true)} on a {@code Window},
  97  *     {@code Frame} or {@code Dialog} may occur
  98  *     asynchronously.
  99  *
 100  * <li>Setting the size or location of a top-level container.
 101  * <br>Calls to {@code setSize}, {@code setBounds} or
 102  *     {@code setLocation} on a {@code Window},
 103  *     {@code Frame} or {@code Dialog} are forwarded
 104  *     to the underlying window management system and may be
 105  *     ignored or modified.  See {@link java.awt.Window} for
 106  *     more information.
 107  * </ul>
 108  * <p>
 109  * Most applications should not call any of the methods in this
 110  * class directly. The methods defined by {@code Toolkit} are
 111  * the "glue" that joins the platform-independent classes in the
 112  * {@code java.awt} package with their counterparts in




  72  * to particular native toolkit implementations.
  73  * <p>
  74  * Many GUI events may be delivered to user
  75  * asynchronously, if the opposite is not specified explicitly.
  76  * As well as
  77  * many GUI operations may be performed asynchronously.
  78  * This fact means that if the state of a component is set, and then
  79  * the state immediately queried, the returned value may not yet
  80  * reflect the requested change.  This behavior includes, but is not
  81  * limited to:
  82  * <ul>
  83  * <li>Scrolling to a specified position.
  84  * <br>For example, calling {@code ScrollPane.setScrollPosition}
  85  *     and then {@code getScrollPosition} may return an incorrect
  86  *     value if the original request has not yet been processed.
  87  *
  88  * <li>Moving the focus from one component to another.
  89  * <br>For more information, see
  90  * <a href="http://docs.oracle.com/javase/tutorial/uiswing/misc/focus.html#transferTiming">Timing
  91  * Focus Transfers</a>, a section in
  92  * <a href="http://docs.oracle.com/javase/tutorial/uiswing/">The Swing
  93  * Tutorial</a>.
  94  *
  95  * <li>Making a top-level container visible.
  96  * <br>Calling {@code setVisible(true)} on a {@code Window},
  97  *     {@code Frame} or {@code Dialog} may occur
  98  *     asynchronously.
  99  *
 100  * <li>Setting the size or location of a top-level container.
 101  * <br>Calls to {@code setSize}, {@code setBounds} or
 102  *     {@code setLocation} on a {@code Window},
 103  *     {@code Frame} or {@code Dialog} are forwarded
 104  *     to the underlying window management system and may be
 105  *     ignored or modified.  See {@link java.awt.Window} for
 106  *     more information.
 107  * </ul>
 108  * <p>
 109  * Most applications should not call any of the methods in this
 110  * class directly. The methods defined by {@code Toolkit} are
 111  * the "glue" that joins the platform-independent classes in the
 112  * {@code java.awt} package with their counterparts in


< prev index next >