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

chrome/common/extensions/api/app_window.idl

Index: chrome/common/extensions/api/app_window.idl
diff --git a/chrome/common/extensions/api/app_window.idl b/chrome/common/extensions/api/app_window.idl
index b08037bf327bddf1dfbb1ba6e508493e54cff19d..edc19961031bab5cbd3abdc1fe2308f6f30566a8 100644
--- a/chrome/common/extensions/api/app_window.idl
+++ b/chrome/common/extensions/api/app_window.idl
@@ -351,6 +351,17 @@ namespace app.window {
     // <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;
 
@@ -435,5 +446,8 @@ namespace app.window {
 
     // 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.

   };
 };