Create windows for new app window bounds API

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 {
 
   // Previously named Bounds.
   dictionary ContentBounds {
     long? left;
     long? top;
     long? width;
     long? height;
   };
 
-  [nodoc] dictionary BoundsSpecification {
+  dictionary BoundsSpecification {
     // The X coordinate of the content or window.
     long? left;
 
     // The Y coordinate of the content or window.
     long? top;
 
     // The width of the content or window.
     long? width;
 
     // The height of the content or window.
@@ skipping 57 matching lines @@
 
   dictionary CreateWindowOptions {
     // Id to identify the window. This will be used to remember the size
     // and position of the window and restore that geometry when a window
     // with the same id is later opened.
     // If a window with a given id is created while another window with the same
     // id already exists, the currently opened window will be focused instead of
     // creating a new window.
     DOMString? id;
 
+    // Used to specify the initial position, initial size and constraints of the
+    // window's content (excluding window decorations).
+    // If an <code>id</code> is also specified and a window with a matching
+    // <code>id</code> has been shown before, the remembered bounds will be used
+    // instead.
+    //
+    // Note that the padding between the inner and outer bounds is determined by
+    // the OS. Therefore setting the same bounds property for both the
+    // <code>innerBounds</code> and <code>outerBounds</code> will result in an
+    // error.
+    //
+    // Currently only available on the Dev channel from Chrome 35.
+    BoundsSpecification? innerBounds;
+
+    // Used to specify the initial position, initial size and constraints of the
+    // window (including window decorations such as the title bar and frame).
+    // If an <code>id</code> is also specified and a window with a matching
+    // <code>id</code> has been shown before, the remembered bounds will be used
+    // instead.
+    //
+    // Note that the padding between the inner and outer bounds is determined by
+    // the OS. Therefore setting the same bounds property for both the
+    // <code>innerBounds</code> and <code>outerBounds</code> will result in an
+    // error.
+    //
+    // Currently only available on the Dev channel from Chrome 35.
+    BoundsSpecification? outerBounds;
+
     // Default width of the window.
     [nodoc, deprecated="Use $ref:BoundsSpecification."] long? defaultWidth;
 
     // Default height of the window.
     [nodoc, deprecated="Use $ref:BoundsSpecification."] long? defaultHeight;
 
     // Default X coordinate of the window.
     [nodoc, deprecated="Use $ref:BoundsSpecification."] long? defaultLeft;
 
     // Default Y coordinate of the window.
@@ skipping 139 matching lines @@
 
     // Hide the window. Does nothing if the window is already hidden.
     static void hide();
 
     // Get the window's inner bounds as a $ref:ContentBounds object.
     [nocompile] static ContentBounds getBounds();
 
     // Set the window's inner bounds.
     static void setBounds(ContentBounds bounds);
 
-    // Get the current minimum width of the window. Returns |undefined| if there
-    // is no minimum. Currently only available on the Dev channel.
+    // Get the current minimum width of the window. Returns <code>null</code> if
+    // there is no minimum. Currently only available on the Dev channel.
     [nocompile] static long getMinWidth();
 
-    // Get the current minimum height of the window. Returns |undefined| if
-    // there is no minimum. Currently only available on the Dev channel.
+    // Get the current minimum height of the window. Returns <code>null</code>
+    // if there is no minimum. Currently only available on the Dev channel.
     [nocompile] static long getMinHeight();
 
-    // Get the current maximum width of the window. Returns |undefined| if there
-    // is no maximum. Currently only available on the Dev channel.
+    // Get the current maximum width of the window. Returns <code>null</code> if
+    // there is no maximum. Currently only available on the Dev channel.
     [nocompile] static long getMaxWidth();
 
-    // Get the current maximum height of the window. Returns |undefined| if
-    // there is no maximum. Currently only available on the Dev channel.
+    // Get the current maximum height of the window. Returns <code>null</code>
+    // if there is no maximum. Currently only available on the Dev channel.
     [nocompile] static long getMaxHeight();
 
-    // Set the current minimum width of the window. Set to |null| to remove the
-    // constraint. Currently only available on the Dev channel.
+    // Set the current minimum width of the window. Set to <code>null</code> to
+    // remove the constraint. Currently only available on the Dev channel.
     static void setMinWidth(optional long minWidth);
 
-    // Set the current minimum height of the window. Set to |null| to remove the
-    // constraint. Currently only available on the Dev channel.
+    // Set the current minimum height of the window. Set to <code>null</code> to
+    // remove the constraint. Currently only available on the Dev channel.
     static void setMinHeight(optional long minHeight);
 
-    // Set the current maximum width of the window. Set to |null| to remove the
-    // constraint. Currently only available on the Dev channel.
+    // Set the current maximum width of the window. Set to <code>null</code> to
+    // remove the constraint. Currently only available on the Dev channel.
     static void setMaxWidth(optional long maxWidth);
 
-    // Set the current maximum height of the window. Set to |null| to remove the
-    // constraint. Currently only available on the Dev channel.
+    // Set the current maximum height of the window. Set to <code>null</code> to
+    // remove the constraint. Currently only available on the Dev channel.
     static void setMaxHeight(optional long maxHeight);
 
     // 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 iconUrl);
 
     // Set a badge icon for the window.
     // TODO(benwells): Document this properly before going to stable.
     [nodoc] static void setBadgeIcon(DOMString iconUrl);
@@ skipping 29 matching lines @@
     // Currently only available on the Dev channel from Chrome 35.
     Bounds outerBounds;
   };
 
   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.
     //
-    // Another option is to use the bounds property, which will put the window
-    // at the specified coordinates with the specified size. If the window has
-    // a frame, it's total size will be the size given plus the size of the
-    // frame; that is, the size in bounds is the content size, not the window
-    // size.
+    // Another option is to use the <code>bounds</code> property, which will put
+    // the window at the specified coordinates with the specified size. If the
+    // window has a frame, it's total size will be the size given plus the size
+    // of the frame; that is, the size in bounds is the content size, not the
+    // window size.
     //
     // To automatically remember the positions of windows you can give them ids.
     // If a window has an id, This id is used to remember the size and position
     // of the window whenever it is moved or resized. This size and position is
     // then used instead of the specified bounds on subsequent opening of a
     // window with the same id. If you need to open a window with an id at a
     // location other than the remembered default, you can create it hidden,
     // move it to the desired location, then show it.
     static void create(DOMString url,
                        optional CreateWindowOptions options,
@@ skipping 28 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();
   };
 };