API proposal for chrome.app.window to intercept all keys.

chrome/common/extensions/api/app_window.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.
 
 // Use the <code>chrome.app.window</code> API to create windows. Windows
 // have an optional frame with title bar and size controls. They are not
 // associated with any Chrome browser windows. See the <a
 // href="https://github.com/GoogleChrome/chrome-app-samples/tree/master/window-state">
 // Window State Sample</a> for a demonstration of these options.
 namespace app.window {
@@ skipping 333 matching lines @@
     // Accessors for testing.
     [nodoc] boolean hasFrameColor;
     [nodoc] long activeFrameColor;
     [nodoc] long inactiveFrameColor;
     [nodoc] boolean? firstShowHasHappened;
 
     // Set whether the window should stay above most other windows. Requires the
     // <code>"alwaysOnTopWindows"</code> permission.
     static void setAlwaysOnTop(boolean alwaysOnTop);
 
+    // Set whether the window should get all keyboard events including system
+    // keys that are usually not sent. This currently works only when the
+    // windows is in fullscreen. Requires the <code>"app.window.allKeys"</code>

[Jamie, 2014/06/27 17:32:20]

Is the full-screen comment correct? Also, please add that this is best-effort,
and may be subject to platform-specific constraints.

[Sriram, 2014/06/27 17:39:40]

Done.

+    // permission.
+    static void setAllKeysIntercept(boolean wantAllKeys);
+
+    // Return whether the current window will get all keyboard events including
+    // system keys. A window might not get all keys even if setAllKeysIntercept
+    // was called as user might have declined to access.
+    static boolean getAllKeysIntercept();
+
     // The JavaScript 'window' object for the created child.
     [instanceOf=Window] object contentWindow;
 
     // The id the window was created with.
     DOMString id;
 
     // The position, size and constraints of the window's content, which does
     // not include window decorations.
     // This property is new in Chrome 36.
     Bounds innerBounds;
@@ skipping 64 matching lines @@
     [nocompile] static void onMaximized();
 
     // Fired when the window is minimized.
     [nocompile] static void onMinimized();
 
     // Fired when the window is restored from being minimized or maximized.
     [nocompile] static void onRestored();
 
     // Event for testing. Lets tests wait until a window has been shown.
     [nocompile, nodoc] static void onWindowFirstShown();
+
+    // Fired when AllKeysIntercept setting is changed.
+    [nocompile] static void onWantAllKeysInterceptChanged();

[Jamie, 2014/06/27 17:32:20]

Nit: The other methods don't mention "Want" any more. I think this would be
better (and shorter!) as onAllKeysInterceptChanged.

[Sriram, 2014/06/27 17:39:40]

Done.

   };
 };