chrome.app.window

窗口的大小与位置可以以几种不同的方式指定。最简单的选择是什么都不指定，这种情况下会使用默认大小与平台相关的位置。

另一种选择是使用 bounds 属性，这样窗口总是会放在指定位置并且具有指定大小。如果窗口有边框，它的总大小是指定大小加上边框的大小。也就是说，bounds 中的大小是内容大小，而不是窗口大小。

如果要自动记录窗口的位置，您可以为它们提供标识符。如果窗口有标识符，该标识符将在窗口移动或调整大小时用于记录它的大小和位置。以后打开具有同样标识符的窗口时使用这一大小和位置，而不是指定的大小和位置。如果您需要打开一个具有标识符的窗口，并且使用不同于记录的默认位置，您可以使它创建时隐藏，将它移动到期望的位置，然后显示它。

参数

url ( string )

options ( optional object )

属性

id ( optional string )

用于标识窗口的标识符，会用来记住窗口的大小与位置，当同一标识符的窗口再次打开时恢复原来的尺寸。如果创建窗口时另一个具有同样标识符的窗口已经存在，当前打开的窗口将获得焦点，而不会创建新窗口。

minWidth ( optional integer )

窗口的最小宽度。

minHeight ( optional integer )

窗口的最小高度。

maxWidth ( optional integer )

窗口的最大宽度。

maxHeight ( optional integer )

窗口的最大高度。

frame ( optional string )

框架类型：'none' 或 'chrome'（默认为 'chrome'）。如果使用 'none'，可以通过 CSS 属性 -webkit-app-region 设置应用窗口的拖放特性。-webkit-app-region: drag 可以将区域标志为可拖放的，而 no-drag 可以用来在嵌套元素上禁用该样式。

bounds ( optional Bounds )

窗口中内容的大小与位置（不包括标题栏）。如果同时指定了 id，并且以前显示过匹配标识符的窗口，则会使用记录下来的窗口大小与位置。

transparentBackground ( optional boolean )

启用窗口背景透明，仅在 ash 中支持，需要实验性 API 权限。

state ( optional enum of "normal", "fullscreen", "maximized", or "minimized" )

窗口的初始状态，允许使它在创建时就全屏、最大化或最小化。默认为 'normal'（正常）。

hidden ( optional boolean )

如果为 true，该窗口创建后将处于隐藏状态，创建之后在该窗口上调用 show() 可以显示它。默认为 false。

resizable ( optional boolean )

如果为 true 的话，用户可以调整窗口的大小。默认为 true。

alwaysOnTop ( optional boolean )

如果为 true，窗口会保持在其他大部分窗口之上。如果有多个这样的窗口，当前具有焦点的窗口会在前台。需要 "alwaysOnTopWindows" 权限，默认为 false。创建窗口后调用 setAlwaysOnTop 修改该属性。当前仅在 Dev 分支可用。

focused ( optional boolean )

如果为 true，窗口创建时具有焦点。默认为 true。

callback ( optional function )

在已创建窗口（子窗口）的 load 事件产生前在父窗口中调用，父窗口可以设置子窗口中的字段或函数，以便在 onload 中使用。例如：background.js：
function(createdWindow) { createdWindow.contentWindow.foo = function () { }; };
window.js：
window.onload = function () { foo(); }

如果您指定了 callback 参数，它应该指定一个如下形式的函数：

function(appwindow createdWindow) {...};

createdWindow ( appwindow )

返回当前脚本上下文（即 JavaScript window 对象）的 AppWindow 对象。这也可以在另一个页面的脚本上下文句柄上调用，例如 otherWindow.chrome.app.window.current()。

获取所有当前创建的应用窗口数组。该方法在 Chrome 33 中新增。

获取指定标识符的 AppWindow 对象，如果没有指定标识符的窗口则返回 null。该方法在 Chrome 33 中新增。

参数

id ( string )

当窗口改变大小时产生。

function() {...};

当窗口关闭时产生。

function() {...};

窗口全屏时产生。

function() {...};

当窗口最大化时产生。 Fired when the window is maximized.

function() {...};

当窗口最小化时产生。

function() {...};

当窗口从最小化或最大化的状态恢复时产生。

function() {...};