屏幕屬性

屏幕屬性提供管理顯示設(shè)備的一些基礎(chǔ)能力，包括獲取默認(rèn)顯示設(shè)備的信息，獲取所有顯示設(shè)備的信息以及監(jiān)聽(tīng)顯示設(shè)備的插拔行為。

說(shuō)明：
開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模塊首批接口從API version 7開(kāi)始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

導(dǎo)入模塊

import display from '@ohos.display';

DisplayState

用于表示顯示設(shè)備的狀態(tài)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

Display

描述display對(duì)象的屬性。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

display.getDefaultDisplay

getDefaultDisplay(callback: AsyncCallback): void

獲取當(dāng)前默認(rèn)的display對(duì)象。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

var displayClass = null;
display.getDefaultDisplay((err, data) = > {
    if (err.code) {
        console.error('Failed to obtain the default display object. Code:  ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in obtaining the default display object. Data:' + JSON.stringify(data));
    displayClass = data;
});

display.getDefaultDisplay

getDefaultDisplay(): Promise

獲取當(dāng)前默認(rèn)的display對(duì)象。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

示例：

let promise = display.getDefaultDisplay();
promise.then(() = > {
    console.log('getDefaultDisplay success');
}).catch((err) = > {
    console.log('getDefaultDisplay fail: ' + JSON.stringify(err));
});

display.getAllDisplay

getAllDisplay(callback: AsyncCallback>): void

獲取當(dāng)前所有的display對(duì)象。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

display.getAllDisplay((err, data) = > {
    if (err.code) {
        console.error('Failed to obtain all the display objects. Code: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in obtaining all the display objects. Data: ' + JSON.stringify(data))
});

display.getAllDisplay

getAllDisplay(): Promise>

獲取當(dāng)前所有的display對(duì)象。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

示例：

let promise = display.getAllDisplay();
promise.then(() = > {
    console.log('getAllDisplay success');
}).catch((err) = > {
    console.log('getAllDisplay fail: ' + JSON.stringify(err));
});

display.on('add'|'remove'|'change')

on(type: 'add'|'remove'|'change', callback: Callback): void

開(kāi)啟監(jiān)聽(tīng)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

var callback = (data) = > {
    console.info('Listening enabled. Data: ' + JSON.stringify(data))
}
display.on("add", callback);

display.off('add'|'remove'|'change')

off(type: 'add'|'remove'|'change', callback?: Callback): void

關(guān)閉監(jiān)聽(tīng)。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

參數(shù)：

示例：

display.off("remove");

審核編輯 黃宇