Plumb through the page focus lost event to Pepper plugins.

ppapi/c/ppp_instance.h

 /* Copyright (c) 2012 The Chromium Authors. All rights reserved.
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
-/* From ppp_instance.idl modified Mon Feb  6 14:04:52 2012. */
+/* From ppp_instance.idl modified Thu Jun 28 15:08:39 2012. */
 
 #ifndef PPAPI_C_PPP_INSTANCE_H_
 #define PPAPI_C_PPP_INSTANCE_H_
 
 #include "ppapi/c/pp_bool.h"
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_macros.h"
 #include "ppapi/c/pp_point.h"
 #include "ppapi/c/pp_rect.h"
 #include "ppapi/c/pp_resource.h"
@@ skipping 97 matching lines @@
   /**
    * <code>DidChangeView() is called when the position, size, or other view
    * attributes of the instance has changed.
    */
   void (*DidChangeView)(PP_Instance instance, PP_Resource view);
   /**
    * DidChangeFocus() is called when an instance has gained or lost focus.
    * Having focus means that keyboard events will be sent to the instance.
    * An instance's default condition is that it will not have focus.
    *
+   * The focus flag takes into account both browser tab and window focus as
+   * well as focus of the plugin element on the page. In order to be deemed
+   * to have focus, the browser window must be topmost, the tab must be
+   * selected in the window, and the instance must be the focused element on
+   * the page.
+   *
    * <strong>Note:</strong>Clicks on instances will give focus only if you
    * 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>.
+   * to make sure you're either requesting them via
+   * <code>RequestInputEvents()<code> (which implicitly marks all input events
+   * as consumed) or via <code>RequestFilteringInputEvents()</code> and
+   * returning true from your event handler.
    *
    * @param[in] instance A <code>PP_Instance</code> identifying the instance
    * receiving the input event.
    *
    * @param[in] has_focus Indicates the new focused state of the instance.
    */
   void (*DidChangeFocus)(PP_Instance instance, PP_Bool has_focus);
   /**
    * HandleDocumentLoad() is called after initialize for a full-frame
    * module that was instantiated based on the MIME type of a DOMWindow
@@ skipping 37 matching lines @@
                         const struct PP_Rect* clip);
   void (*DidChangeFocus)(PP_Instance instance, PP_Bool has_focus);
   PP_Bool (*HandleDocumentLoad)(PP_Instance instance, PP_Resource url_loader);
 };
 /**
  * @}
  */
 
 #endif  /* PPAPI_C_PPP_INSTANCE_H_ */