sogouExplorer.windows. 对应Chrome扩展的 chrome.windows.( http://code.google.com/chrome/extensions/windows.html ),目的是控制标签的操作.包括创建,修改,重新排列标签页.

API参考：sogouExplorer.windows

属性

WINDOW_ID_NONE( integer )

sogouExplorer.windows.WINDOW_ID_NONE

  1. 这个属性代表了失去焦点的窗口的ID。

方法

create

sogouExplorer.windows.create(object createData, fucntion callback)

  1. 创建一个新的浏览器窗口，提供的参数包括大小，位置，默认URL等。
  2.  
  3. 参数 
  4. createData( 可选 object ) 
  5.  url ( 可选 string 或者 array of string ) 
  6.    提供一个或者多个URL，以便在新浏览器窗口创建的时候打开这些URL。如果没有提供这个参数，那么将会创建一个空白的
  7.    页面。
  8.  tabId( 可选 integer ) 
  9.    指定想要打开的标签页的ID。
  10.  left( 可选 integer ) 
  11.    给定一个像素值，代表新创建的浏览器窗口的左边缘到屏幕左边缘的距离。如果没有提供这个参数，那么默认的情况下会使用
  12.    上一个浏览器窗口的位置。
  13.  top( 可选 integer ) 
  14.    给定一个像素值，代表新创建的浏览器窗口的上边缘到屏幕上边缘的距离。如果没有提供这个参数，那么默认的情况下会使用
  15.    上一个浏览器窗口的位置。
  16.  width( 可选 integer ) 
  17.    给定一个像素值，用来设置新创建的浏览器窗口的宽度。如果没有提供这个参数，那么将会使用浏览器提供的原始值。
  18.  height( 可选 integer ) 
  19.    给定一个像素值，用来设置新创建的浏览器窗口的高度。如果没有提供这个参数，那么将会使用浏览器提供的原始值。
  20.  focused( 可选 boolean ) 
  21.    指定浏览器窗口是否获得焦点。
  22.  accountNumber( 可选 integer ) 
  23.    使用浏览器小号窗口功能，窗口小号编号。
  24.  type( 可选 enumerated string ["normal", "popup", "panel"]) (panel暂不支持)
  25.    指定浏览器窗口的类型，有三种选择，分别是"normal", "popup", "panel"。
  26. callback( 可选 function ) 
  27.  
  28. Callback function 
  29.    如果指定了callback方法，那么它应该如下所示：
  30.      fucntion(Window window){...};
  31.    window( 可选 Window )

get

sogouExplorer.windows.get(integer windowId, function callback)

  1. 获得浏览器窗口的详细信息。
  2.  
  3. 参数 
  4. windowId( integer ) 
  5.    浏览器窗口的ID。
  6. callback( function ) 
  7.    获得了所需要的信息后，执行该方法。
  8.  
  9. Callback 方法 
  10.    如果指定了callback方法，那么它应该如下所示：
  11.      function(Window window){...};
  12.    window( Window )

getAll

sogouExplorer.windows.getAll(object getInfo, function callback)

  1. 得到所有浏览器窗口的详细信息。
  2.  
  3. 参数 
  4. getInfo( 可选 object ) 
  5.   populate( 可选 boolean ) 
  6.     如果设定了populate为true，那么每一个浏览器窗口的标签页( Tab类型 )信息都将会存储在各自的window属性中，存储
  7.      的形式为list。
  8.  
  9. Callback方法 
  10.    如果指定了callback方法，那么它应该如下所示：
  11.      function(array of Window windows){...};
  12.    windows( Window类型的数组 )

getCurrent

sogouExplorer.windows.getCurrent(function callback)

  1. 获得当前浏览器窗口的详细信息。
  2.  
  3. 参数 
  4. callback( function ) 
  5.    获得了所需要的信息后，执行该方法。
  6.  
  7. Callback 方法 
  8.    如果指定了callback方法，那么它应该如下所示：
  9.      function(Window window){...};
  10.    window( Window )

getLastFocused

sogouExplorer.windows.getLastFocused(function callback)

  1. 获得最后一个访问的浏览器窗口的信息，一般情况下指的是处在最前端的浏览器窗口。
  2.  
  3. 参数 
  4. callback( function ) 
  5.    获得了所需要的信息后，执行该方法。
  6.  
  7. Callback 方法 
  8.    如果指定了callback方法，那么它应该如下所示：
  9.      function(Window window){...};
  10.    window( Window )

remove

sogouExplorer.windows.remove(integer windowId, function callback)

  1. 关闭一个浏览器窗口，同时关闭的还有处在这个窗口中的所有标签页。
  2.  
  3. 参数 
  4. windowId( integer ) 
  5.    指定浏览器窗口的ID。
  6. callback( 可选 function ) 
  7.    指定浏览器窗口的ID。
  8.  
  9. Callback 方法 
  10.    如果指定了callback方法，那么它应该如下所示：
  11.      function(){...};

update

sogouExplorer.windows.update(integer windowId, object updateInfo, function callback)

  1. 更改浏览器的属性值。给定你需要修改的属性值，没有指定的属性并不会被修改。
  2.  
  3. 参数 
  4. windowId( integer ) 
  5.   浏览器窗口的ID。
  6. updateInfo( 可选 object ) 
  7.   left( 可选 integer ) 
  8.    给定一个像素值，代表浏览器窗口的左边缘到屏幕左边缘的距离。
  9.   top( 可选 integer ) 
  10.    给定一个像素值，代表浏览器窗口的上边缘到屏幕上边缘的距离。
  11.   width( 可选 integer ) 
  12.    给定一个像素值，用来设置浏览器窗口的宽度。
  13.   height( 可选 integer ) 
  14.    给定一个像素值，用来设置浏览器窗口的高度。
  15.   focused( 可选 boolean ) 
  16.    指定浏览器窗口是否获得焦点。如果为true，浏览器窗口设置到最前端。如果为false，依照在z-order中的排序将下一个
  17.    浏览器窗口移到最前端。
  18. callback( 可选 function ) 
  19.  
  20. Callback function 
  21.    如果指定了callback方法，那么它应该如下所示：
  22.      fucntion(Window window){...};
  23.    window( 可选 Window )

事件

onCreated

sogouExplorer.windows.onCreated.addListener(function(Window window) {…}));

  1. 每当创建了一个新的浏览器窗口，该方法被触发。
  2.  
  3. Listener参数 
  4. window( Window ) 
  5.   所创建的窗口的详细信息。

onFocusChanged (暂不支持)

sogouExplorer.windows.onFocusChanged.addListener(function(integer windowId){…}));

  1. 当浏览器窗口的焦点变化的时候，该方法被触发。需要注意的是，如果所有的浏览器窗口都失去了焦点，那么应该是
  2. sogouExplorer.windows.WINDOW_ID_NONE。
  3.  
  4. Listener参数 
  5. windowId( integer )
  6.   获得焦点的浏览器窗口的ID。

onRemoved

sogouExplorer.windows.onRemoved.addListener(function(integer windowId){…}));

  1. 当浏览器窗口被关闭的时候，该方法被触发。
  2.  
  3. Listener参数 
  4. windowId( integer ) 
  5.   被关闭的浏览器窗口的ID。

类型

Window( object )

  1. id( integer ) 
  2.   浏览器窗口的ID值。这个值在浏览器session中是唯一的。
  3. focused( boolean ) 
  4.   当前浏览器窗口是否获得焦点。
  5. top( integer ) 
  6.   浏览器窗口的上边缘到屏幕顶部的像素值。
  7. left( integer ) 
  8.   浏览器窗口的左边缘到屏幕左端的像素值。
  9. width( integer ) 
  10.   浏览器窗口的宽度的像素值。
  11. height( integer ) 
  12.   浏览器窗口的高度的像素值。
  13. tabs( 可选 array of Tab ) 
  14.   装有Tab类型的数组，代表了浏览器窗口中的标签页的信息。
  15. incognito( boolean ) 
  16.   浏览器是否处于隐身模式下。
  17. type( enumerated string ["normal", "popup", "panel", "app"]) 
  18.   浏览器窗口的类型。可以是枚举类型中"normal", "popup", "panel", "app"的任意一种。