Reviewers: jlabanca,

Description:
Adds a warning to the javadoc for Event#addNativePreviewHandler
explaining its cross-app limitations.

Please review this at http://gwt-code-reviews.appspot.com/51821

Affected files:
   user/src/com/google/gwt/user/client/Event.java


Index: user/src/com/google/gwt/user/client/Event.java
--- user/src/com/google/gwt/user/client/Event.java      (revision 5759)
+++ user/src/com/google/gwt/user/client/Event.java      (working copy)
@@ -387,6 +387,12 @@ public class Event extends NativeEvent {
     * {...@link NativePreviewEvent} that was added is the first to be fired.
     * </p>
     *
+   * <p>
+   * Please note that nondeterministic behavior will result
+   * if more than one GWT application registers preview handlers for
+   * the same event type.
+   * </p>
+   *
     * @param handler the {...@link NativePreviewHandler}
     * @return {...@link HandlerRegistration} used to remove this handler
     */




--~--~---------~--~----~------------~-------~--~----~
http://groups.google.com/group/Google-Web-Toolkit-Contributors
-~----------~----~----~----~------~----~------~--~---

Reply via email to