chrome.system.display

获取所有已连接显示设备的信息。

参数

callback ( function )

callback 参数应该指定一个如下形式的函数：

function(array of object displayInfo) {...};

displayInfo ( array of object )

每一个对象的属性

id ( string )

显示器的唯一标识符。

name ( string )

用户友好的名称（例如“HP LCD monitor”）。

mirroringSourceId ( string )

在显示单元上镜像的显示器标识符，如果没有镜像则设为空字符串。当前仅在 Chrome OS 上可用，在其他平台上为空字符串。

isPrimary ( boolean )

如果是主显示器则为 true。

isInternal ( boolean )

如果是内部显示器则为 true。

isEnabled ( boolean )

如果显示器已启用则为 true。

dpiX ( double )

沿着宽度方向每英寸的像素数目。

dpiY ( double )

沿着高度方向每英寸的像素数目。

rotation ( integer )

显示器相对与垂直位置顺时针转过的角度。目前仅在 Chrome OS 上可用，在其他平台上设置为 0。

bounds ( Bounds )

显示器的逻辑范围。

overscan ( Insets )

显示器在其屏幕范围内的位置。目前仅在 Chrome OS 上可用，在其他平台上为空。

workArea ( Bounds )

显示器在显示器范围内的可用工作区域，该工作区域不包括保留给操作系统（例如任务栏与执行器）的显示区域。

根据 info 中提供的信息更新 id 指定的显示器属性。如果失败会设置 runtime.lastError。

参数

id ( string )

显示器的唯一标识符。

info ( object )

要更改的显示器属性的信息，只有在 info 中指定新值时属性才会更改。

属性

mirroringSourceId ( optional string )

如果设置了该参数并且不为空，开始当前显示器与指定标识符的显示器之间的镜像（系统会确定镜像哪一个显示器）。如果设置了该参数并且为空，停止当前显示器与指定标识符的显示器之间的镜像（如果正在镜像）。设置了该参数后，不能设置其他参数。

isPrimary ( optional boolean )

如果设置为 true，使当前显示器变成主显示器。设置为 false 则不进行任何操作。

overscan ( optional Insets )

如果设置了该参数，将显示器的过扫描设置为指定值。注意，过扫描值不能为负，也不能大于屏幕大小的一半，内部显示器的过扫描值不能更改。该参数在 isPrimary 参数之后应用。

rotation ( optional integer )

如果设置了该参数，更新显示器的旋转角度，有效值包括 0、90、18、270，相对于显示器的垂直位置顺时针旋转。该参数在 overscan 参数之后应用。

boundsOriginX ( optional integer )

如果设置了该参数，更新显示器沿 x 轴方向的逻辑范围原点，如果设置了 boundsOriginY 的话与 boundsOriginY 同时应用。注意，更新显示器原点时可能会有一些约束，最终的范围原点可能与设置的不一样，最终的范围可以使用 getInfo 获取。范围原点在 rotation 之后应用，不能在主显示器上更改。注意，如果还设置了 isPrimary 就不能再设置范围原点值，因为首先应用 isPrimary 参数。

boundsOriginY ( optional integer )

如果设置了该参数，更新显示器沿 y 轴方向的逻辑范围原点。参见 boundsOriginX 参数的文档。

callback ( optional function )

该函数完成时调用的空函数，要想确定函数是否成功，可以查询 runtime.lastError。

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

function() {...};

Fired when anything changes to the display configuration.

function() {...};