Add the app.windows.getBounds method

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.
 
 namespace app.window {
   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 (and no explicit size or position) is later opened.
     DOMString? id;
@@ skipping 37 matching lines @@
     // Window type: 'shell' (the default) is the only currently supported value.
     DOMString? type;
 
     // Frame type: 'none' or 'chrome' (defaults to 'chrome').
     DOMString? frame;
   };
 
   callback CreateWindowCallback =
       void ([instanceOf=AppWindow] object created_window);
 
+  dictionary Bounds {
+    long left;
+    long top;
+    long width;
+    long height;

[jeremya, 2012/10/31 03:12:21]

These should be optional. I think it makes sense to call eg.

win.setBounds({ width: 100, height: 100, left: 20 });

[asargent_no_longer_on_chrome, 2012/10/31 05:37:35]

Done.

+  };
+
   dictionary AppWindow {
     // Focus the window.
     static void focus();
 
     // Minimize the window.
     static void minimize();
 
     // Maximize the window.
     static void maximize();
 
     // Restore the window.
     static void restore();
 
-    // Move the window to the position (|x|, |y|).
-    static void moveTo(long x, long y);
+    // Move the window to the position (|left|, |top|).
+    static void moveTo(long left, long top);
 
     // Resize the window to |width|x|height| pixels in size.
     static void resizeTo(long width, long height);
 
     // Draw attention to the window.
     static void drawAttention();
 
     // Clear attention to the window.
     static void clearAttention();
 
     // Close the window.
     static void close();
 
+    // Return a <a href="#type-Bounds">Bounds</a> with the position and size of
+    // the window.
+    static Bounds getBounds();
+
     // The JavaScript 'window' object for the created child.
     [instanceOf=global] 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 14 matching lines @@
     // but individual coordinates are not. So if you specify a top (or left)
     // coordinate, you should also specify a left (or top) coordinate, and
     // similar for size.
     //
     // If you specify both a regular and a default value for the same option
     // the regular value is the only one that takes effect.
     static void create(DOMString url,
                        optional CreateWindowOptions options,
                        optional CreateWindowCallback callback);
 
+    // Returns the current <a href="#type-AppWindow">AppWindow</a>.

[jeremya, 2012/10/31 00:32:46]

I don't think this really makes clear the behaviour of current() -- perhaps
something like 'returns the AppWindow of the calling context'? Or maybe that's
too technical...

[asargent_no_longer_on_chrome, 2012/10/31 05:37:35]

I tried rewording it to use similar language to the comments for the
chrome.extension.getViews and chrome.runtime.getBackgroundPage methods. Feel
free to change it if you can think of something better. :)

     [nocompile] static AppWindow current();
     [nocompile, nodoc] static void initializeAppWindow(object state);
   };
 };