Add always-on-top property to app windows

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.
 namespace app.window {
   dictionary Bounds {
     long? left;
@@ skipping 85 matching lines @@
 
     // If true, the window will be resizable by the user. Defaults to true.
     boolean? resizable;
 
     // By default if you specify an id for the window, the window will only be
     // created if another window with the same id doesn't already exist. If a
     // window with the same id already exists that window is activated instead.
     // If you do want to create multiple windows with the same id, you can
     // set this property to false.
     boolean? singleton;
+
+    // If true, the window will stay above most other windows. If there are
+    // multiple windows of this kind, the currently focused window will be in
+    // the foreground. Defaults to false. Call <code>setAlwaysOnTop()</code> on
+    // the window to change this property after creation.
+    // Currently available in the Dev channel only.
+    [nodoc] boolean? alwaysOnTop;

[benwells, 2013/10/09 02:00:50]

Why are these nodoc?

[tmdiep, 2013/10/09 06:18:08]

Removed [nodoc].

   };
 
   // Called in the creating window (parent) before the load event is called in
   // the created window (child). The parent can set fields or functions on the
   // child usable from onload. E.g. background.js:<br>
   // <code>function(created_window) { created_window.contentWindow.foo =
   // function () { }; };</code>
   // <br>window.js:<br>
   // <code>window.onload = function () { foo(); }</code>
   callback CreateWindowCallback =
@@ skipping 49 matching lines @@
     [nocompile] static Bounds getBounds();
 
     // Set the window's bounds.
     static void setBounds(Bounds bounds);
 
     // Set the app icon for the window (experimental).
     // Currently this is only being implemented on Ash.
     // TODO(stevenjb): Investigate implementing this on Windows and OSX.
     [nodoc] static void setIcon(DOMString icon_url);
 
+    // Is the window always on top?
+    // Currently available in the Dev channel only.
+    [nodoc] static boolean isAlwaysOnTop();
+
+    // Set whether the window should stay above most other windows.
+    // Currently available in the Dev channel only.
+    [nodoc] static void setAlwaysOnTop(boolean always_on_top);
+
     // The JavaScript 'window' object for the created child.
     [instanceOf=Window] object contentWindow;
   };
 
   interface Functions {
     // The size and position of a window can be specified in a number of
     // different ways. The most simple option is not specifying anything at
     // all, in which case a default size and platform dependent position will
     // be used.
     //
@@ skipping 35 matching lines @@
     // Fired when the window is maximized.
     [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();
   };
 };