chrome.system.display

描述 使用 chrome.system.display API 查询显示器的元数据。
可用版本 从 Chrome 30 开始支持。
权限 "system.display"

摘要

类型
Bounds
Insets
方法
getInfo chrome.system.display.getInfo(function callback)

类型

Bounds

属性
integer left

左上角的 X 坐标。

integer top

左上角的 Y 坐标。

integer width

显示器宽度,以像素为单位。

integer height

显示器高度,以像素为单位。

Insets

属性
integer left

与左边界之间的 x 轴距离。

integer top

与顶部边界之间的 y 轴距离。

integer right

与右边界之间的 x 轴距离。

integer bottom

与底部边界之间的 y 轴距离。

方法

getInfo

chrome.system.display.getInfo(function callback)

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

参数
function callback

callback 参数应该是一个如下形式的函数:

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

每一个对象的属性

string id

显示器的唯一标识符。

string name

用户友好的名称(例如“HP LCD monitor”)。

string mirroringSourceId

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

boolean isPrimary

如果是主显示器则为 true。

boolean isInternal

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

boolean isEnabled

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

double dpiX

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

double dpiY

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

integer rotation

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

Bounds bounds

显示器的逻辑范围。

Insets overscan

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

Bounds workArea

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