changeset 6438:298aa6322743

8019236: [macosx] Add javadoc to the handleWindowFocusEvent in CEmbeddedFrame Reviewed-by: ant, serb
author pchelko
date Tue, 02 Jul 2013 12:33:03 +0400
parents b9f86896cd0a
children 6bf5fa233df0
files src/macosx/classes/sun/lwawt/macosx/CEmbeddedFrame.java
diffstat 1 files changed, 11 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/src/macosx/classes/sun/lwawt/macosx/CEmbeddedFrame.java	Fri Jun 28 10:04:15 2013 -0700
+++ b/src/macosx/classes/sun/lwawt/macosx/CEmbeddedFrame.java	Tue Jul 02 12:33:03 2013 +0400
@@ -125,6 +125,17 @@
         }
     }
 
+    /**
+     * When the window is activated and had focus before the deactivation
+     * calling this method triggers focus events in the following order:
+     *  1. WINDOW_ACTIVATED for this EmbeddedFrame
+     *  2. WINDOW_GAINED_FOCUS for this EmbeddedFrame
+     *  3. FOCUS_GAINED for the most recent focus owner in this EmbeddedFrame
+     *
+     * The caller must not requestFocus on the EmbeddedFrame together with calling this method.
+     *
+     * @param parentWindowActive true if the window is activated, false otherwise
+     */
     public void handleWindowFocusEvent(boolean parentWindowActive) {
         this.parentWindowActive = parentWindowActive;
         // ignore focus "lost" native request as it may mistakenly