Plumb through the page focus lost event to Pepper plugins.

ppapi/api/ppp_instance.idl

 /* 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.
  */
 
 /**
  * This file defines the <code>PPP_Instance</code> structure - a series of
  * pointers to methods that you must implement in your module.
  */
 
@@ skipping 159 matching lines @@
       /**
        * A handle to a <code>PPB_View</code> resource identifying the new view.
        */
       [in] 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(
       /* A PP_Instance identifying one instance of a module. */
       [in] PP_Instance instance,
       /* Indicates whether this NaCl module gained or lost event focus. */
@@ skipping 26 matching lines @@
    * @return <code>PP_TRUE</code> if the data was handled,
    * <code>PP_FALSE</code> otherwise.
    */
   PP_Bool HandleDocumentLoad(
       /* A PP_Instance identifying one instance of a module. */
       [in] PP_Instance instance,
       /* A PP_Resource an open PPB_URLLoader instance. */
       [in] PP_Resource url_loader);
 
 };