Functions for accessing app window properties, and modifying AppWindow-specifics

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 {
+  // minimized / maximized state of a window or normal/restored/resizable
+  enum WindowState {normal, minimized, maximized, fullscreen};
+
   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;
 
     // Default width of the window.
     long? defaultWidth;
 
     // Default height of the window.
@@ skipping 33 matching lines @@
     DOMString? type;
 
     // Frame type: 'none' or 'chrome' (defaults to 'chrome').
     DOMString? frame;
   };
 
   callback CreateWindowCallback =
       void ([instanceOf=AppWindow] object created_window);
 
   dictionary AppWindow {
+    // The identity of this window used on creation for persisting state

[Mihai Parparita -not on Chrome, 2012/09/16 05:31:39]

Nit: this was called "id" in the create params, so it should have the same name
here.

[tapted, 2012/09/17 08:48:56]

sticking with `id` in crrev.com/10910304/

+    DOMString windowKey;
+
+    // The internal routing ID, to lookup properties
+    [nodoc] long viewId;
+
+    // The last known width of the window
+    long width;
+
+    // The last known height of the window
+    long height;
+
+    // The last known screenX position
+    long left;
+
+    // The last known screenY position
+    long top;
+
+    // Check if the window currently has focus
+    boolean hasFocus;
+
+    // Get the current window state
+    DOMString windowState;

[Mihai Parparita -not on Chrome, 2012/09/16 05:31:39]

Why not use the WindowState enum here?

[tapted, 2012/09/17 08:48:56]

will do

+
+    // Get the minimum user-resizable dimensions of the window
+    long minWidth;
+    long minHeight;
+
+    // Get the maximum user-resizable dimensions of the window
+    long maxWidth;
+    long maxHeight;
+
+    // Get the window type (e.g. 'shell')
+    DOMString windowType;
+
+    // Get the frame type (e.g. 'none' or 'chrome')
+    DOMString frameType;
+
     // 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);
 
     // Resize the window to |width|x|height| pixels in size.
     static void resizeTo(long width, long height);
 
+    // Update the minimum user-resizable dimensions of the window
+    static void setMinSize(long x, long y);
+
+    // Update the maximum user-resizable dimensions of the window
+    static void setMaxSize(long x, long y);
+
     // 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 15 matching lines @@
     // 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);
 
     [nocompile] static AppWindow current();
+    [internal, nocompile] static void makeAppWindow(object state);
   };
 };