开发者文档
sogouExplorer.windows

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

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


方法

create

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

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


get

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

获得浏览器窗口的详细信息。
 
参数 
windowId( integer ) 
   浏览器窗口的ID。
callback( function ) 
   获得了所需要的信息后,执行该方法。
 
Callback 方法 
   如果指定了callback方法,那么它应该如下所示:
     function(Window window){...};
   window( Window )

getAll

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

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


getCurrent

sogouExplorer.windows.getCurrent(function callback)

获得当前浏览器窗口的详细信息。
 
参数 
callback( function ) 
   获得了所需要的信息后,执行该方法。
 
Callback 方法 
   如果指定了callback方法,那么它应该如下所示:
     function(Window window){...};
   window( Window )


getLastFocused

sogouExplorer.windows.getLastFocused(function callback)

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


remove

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

关闭一个浏览器窗口,同时关闭的还有处在这个窗口中的所有标签页。
 
参数 
windowId( integer ) 
   指定浏览器窗口的ID。
callback( 可选 function ) 
   指定浏览器窗口的ID。
 
Callback 方法 
   如果指定了callback方法,那么它应该如下所示:
     function(){...};


update

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

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


事件

onCreated

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

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

onFocusChanged (暂不支持)

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

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


onRemoved

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

当浏览器窗口被关闭的时候,该方法被触发。
 
Listener参数 
windowId( integer ) 
  被关闭的浏览器窗口的ID。


类型

Window( object )

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