summaryrefslogtreecommitdiffstats
path: root/ppapi/api/ppp_instance.idl
diff options
context:
space:
mode:
Diffstat (limited to 'ppapi/api/ppp_instance.idl')
-rw-r--r--ppapi/api/ppp_instance.idl45
1 files changed, 8 insertions, 37 deletions
diff --git a/ppapi/api/ppp_instance.idl b/ppapi/api/ppp_instance.idl
index da8f7a9..aeb95b1 100644
--- a/ppapi/api/ppp_instance.idl
+++ b/ppapi/api/ppp_instance.idl
@@ -9,7 +9,7 @@
*/
label Chrome {
- M14 = 0.5
+ M14 = 1.0
};
/**
@@ -161,11 +161,13 @@ interface PPP_Instance {
* An instance's default condition is that it will not have focus.
*
* <strong>Note:</strong>Clicks on instances will give focus only if you
- * handle the click event. Return <code>true</code> from HandleInputEvent to
- * signal that the click event was handled. Otherwise the browser will bubble
- * the event and give focus to the element on the page that actually did end
- * up consuming it. If you're not getting focus, check to make sure you're
- * returning true from the mouse click in <code>HandleInputEvent</code>.
+ * handle the click event. Return <code>true</code> from
+ * <code>HandleInputEvent</code> in <code>PPP_InputEvent</code> (or use
+ * unfiltered events) to signal that the click event was handled. Otherwise,
+ * the browser will bubble the event and give focus to the element on the page
+ * that actually did end up consuming it. If you're not getting focus, check
+ * to make sure you're returning true from the mouse click in
+ * <code>HandleInputEvent</code>.
*
* @param[in] instance A <code>PP_Instance</code> indentifying the instance
* receiving the input event.
@@ -179,37 +181,6 @@ interface PPP_Instance {
[in] PP_Bool has_focus);
/**
- * HandleInputEvent() handles input events, such as keyboard events. This
- * function returns <code>PP_TRUE</code> if the event was handled or
- * <code>PP_FALSE</code> if it was not.
- *
- * If the event was handled, it will not be forwarded to the web page or
- * browser. If it was not handled, it will bubble according to the normal
- * rules. So it is important that a module respond accurately with whether
- * event propagation should continue.
- *
- * Event propagation also controls focus. If you handle an event like a mouse
- * event, typically the instance will be given focus. Returning false means
- * that the click will be given to a lower part of the page and your module
- * will not receive focus. This allows an instance to be partially
- * transparent, where clicks on the transparent areas will behave like clicks
- * to the underlying page.
- *
- * @param[in] instance A <code>PP_Instance</code> indentifying one instance
- * of a module.
- *
- * @param[in] event The input event.
- *
- * @return <code>PP_TRUE</code> if <code>event</code> was handled,
- * <code>PP_FALSE</code> otherwise.
- */
- PP_Bool HandleInputEvent(
- /* A PP_Instance indentifying one instance of a module. */
- [in] PP_Instance instance,
- /* The event. */
- [in] PP_InputEvent event);
-
- /**
* HandleDocumentLoad() is called after initialize for a full-frame
* module that was instantiated based on the MIME type of a DOMWindow
* navigation. This situation only applies to modules that are pre-registered