Plumb through the page focus lost event to Pepper plugins.

ppapi/cpp/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.
 
 #ifndef PPAPI_CPP_INSTANCE_H_
 #define PPAPI_CPP_INSTANCE_H_
 
 /// @file
 /// This file defines the C++ wrapper for an instance.
 
@@ skipping 123 matching lines @@
   /// entire region. The time saved doing partial paints is usually not
   /// significant and it can create artifacts when scrolling (this notification
   /// is sent asynchronously from scolling so there can be flashes of old
   /// content in the exposed regions).
   virtual void DidChangeView(const Rect& position, const Rect& clip);
 
   /// 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 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 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] has_focus Indicates the new focused state of the instance.
   virtual void DidChangeFocus(bool has_focus);
 
   /// HandleInputEvent() handles input events from the browser. The default
   /// implementation does nothing and returns false.
   ///
   /// In order to receive input events, you must register for them by calling
   /// RequestInputEvents() or RequestFilteringInputEvents(). By
   /// default, no events are delivered.
@@ skipping 358 matching lines @@
  private:
   PP_Instance pp_instance_;
 
   typedef std::map<std::string, void*> InterfaceNameToObjectMap;
   InterfaceNameToObjectMap interface_name_to_objects_;
 };
 
 }  // namespace pp
 
 #endif  // PPAPI_CPP_INSTANCE_H_