未验证 提交 972b0f80 编写于 作者: O openharmony_ci 提交者: Gitee

!7982 master - API样板化:统一系统接口及模型约束:需同步翻译

Merge pull request !7982 from 葛亚芳/master
......@@ -74,22 +74,24 @@ getDefaultDisplay(callback: AsyncCallback<Display>): void
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback<[Display](#display)> | 是 | 回调函数。返回当前默认的display对象。 |
**示例:**
```js
var displayClass = null;
display.getDefaultDisplay((err, data) => {
```js
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
......@@ -107,14 +109,16 @@ getDefaultDisplay(): Promise<Display>
**示例:**
```js
let promise = display.getDefaultDisplay();
promise.then(() => {
console.log('getDefaultDisplay success');
}).catch((err) => {
console.log('getDefaultDisplay fail: ' + JSON.stringify(err));
});
```
```js
var displayClass = null;
let promise = display.getDefaultDisplay();
promise.then((data) => {
displayClass = data;
console.info('Succeeded in obtaining the default display object. Data:' + JSON.stringify(data));
}).catch((err) => {
console.error('Failed to obtain the default display object. Code: ' + JSON.stringify(err));
});
```
## display.getDefaultDisplaySync<sup>9+</sup>
......@@ -152,15 +156,15 @@ getAllDisplay(callback: AsyncCallback&lt;Array&lt;Display&gt;&gt;): void
**示例:**
```js
display.getAllDisplay((err, data) => {
```js
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))
});
```
console.info('Succeeded in obtaining all the display objects. Data: ' + JSON.stringify(data));
});
```
## display.getAllDisplay
......@@ -178,14 +182,14 @@ getAllDisplay(): Promise&lt;Array&lt;Display&gt;&gt;
**示例:**
```js
let promise = display.getAllDisplay();
promise.then(() => {
console.log('getAllDisplay success');
}).catch((err) => {
console.log('getAllDisplay fail: ' + JSON.stringify(err));
});
```
```js
let promise = display.getAllDisplay();
promise.then((data) => {
console.error('Failed to obtain all the display objects. Code: ' + JSON.stringify(err));
}).catch((err) => {
console.info('Succeeded in obtaining all the display objects. Data: ' + JSON.stringify(data));
});
```
## display.hasPrivateWindow<sup>9+</sup>
......@@ -193,7 +197,7 @@ hasPrivateWindow(displayId: number): boolean
查询指定display对象上是否有可见的隐私窗口。可通过[setPrivacyMode](js-apis-window.md#setprivacymode7)接口设置隐私窗口。隐私窗口内容将无法被截屏或录屏。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
......@@ -211,17 +215,17 @@ hasPrivateWindow(displayId: number): boolean
**示例:**
```js
var ret = display.hasPrivateWindow(displayClass.id);
if (ret == undefined) {
console.log("HasPrivateWindow undefined.");
}
if (ret) {
console.log("HasPrivateWindow.");
} else if (!ret) {
console.log("Don't HasPrivateWindow.");
}
```
```js
var ret = display.hasPrivateWindow(displayClass.id);
if (ret == undefined) {
console.log("Failed to check has privateWindow or not.");
}
if (ret) {
console.log("There has privateWindow.");
} else if (!ret) {
console.log("There has no privateWindow.");
}
```
## display.on('add'|'remove'|'change')
......@@ -232,19 +236,20 @@ on(type: 'add'|'remove'|'change', callback: Callback&lt;number&gt;): void
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 监听事件。<br/>- type为"add",表示增加显示设备事件。<br/>- type为"remove",表示移除显示设备事件。<br/>- type为"change",表示改变显示设备事件。 |
| callback | Callback&lt;number&gt; | 是 | 回调函数。返回监听到的显示设备的id。 |
**示例:**
```js
var callback = (data) => {
console.info('Listening enabled. Data: ' + JSON.stringify(data))
}
display.on("add", callback);
```
```js
var callback = (data) => {
console.info('Listening enabled. Data: ' + JSON.stringify(data))
}
display.on("add", callback);
```
## display.off('add'|'remove'|'change')
......@@ -255,16 +260,17 @@ off(type: 'add'|'remove'|'change', callback?: Callback&lt;number&gt;): void
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 监听事件。<br/>- type为"add",表示增加显示设备事件。<br/>- type为"remove",表示移除显示设备事件。<br/>- type为"change",表示改变显示设备事件。 |
| callback | Callback&lt;number&gt; | 否 | 回调函数。返回监听到的显示设备的id。 |
**示例:**
```js
display.off("remove");
```
```js
display.off("remove");
```
## Display
屏幕实例。描述display对象的属性和方法。
......@@ -301,6 +307,7 @@ getCutoutInfo(callback: AsyncCallback&lt;CutoutInfo&gt;): void
| callback | AsyncCallback&lt;[CutoutInfo](#cutoutinfo9)&gt; | 是 | 回调函数。当获取信息成功,err为undefined,data为获取到的CutoutInfo对象;否则err为错误对象。 |
**示例:**
```js
displayClass.getCutoutInfo((err, data) => {
if (err.code) {
......@@ -318,11 +325,13 @@ getCutoutInfo(): Promise&lt;CutoutInfo&gt;
**系统能力:** SystemCapability.WindowManager.WindowManager.Core
**返回值:**
| 类型 | 说明 |
| ------------------- | ------------------------- |
| Promise&lt;[CutoutInfo](#cutoutinfo9)&gt; | Promise对象,返回描述不可用屏幕区域的CutoutInfo对象。 |
**示例:**
```js
let promise = displayClass.getCutoutInfo();
promise.then((data) => {
......
......@@ -428,7 +428,7 @@ usbFunctionsFromString(funcs: string): number
在设备模式下,将字符串形式的usb功能列表转化为数字掩码。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力:** SystemCapability.USB.USBManager
......@@ -457,7 +457,7 @@ usbFunctionsToString(funcs: FunctionType): string
在设备模式下,将数字掩码形式的usb功能列表转化为字符串。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力:** SystemCapability.USB.USBManager
......@@ -486,7 +486,7 @@ setCurrentFunctions(funcs: FunctionType): Promise\<boolean\>
在设备模式下,设置当前的USB功能列表。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力:** SystemCapability.USB.USBManager
......@@ -515,7 +515,7 @@ getCurrentFunctions(): FunctionType
在设备模式下,获取当前的USB功能列表的数字组合掩码。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力:** SystemCapability.USB.USBManager
......@@ -537,7 +537,7 @@ getPorts(): Array\<USBPort\>
获取所有物理USB端口描述信息。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力:** SystemCapability.USB.USBManager
......@@ -559,7 +559,7 @@ getSupportedModes(portId: number): PortModeType
获取指定的端口支持的模式列表的组合掩码。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力:** SystemCapability.USB.USBManager
......@@ -587,7 +587,7 @@ setPortRoles(portId: number, powerRole: PowerRoleType, dataRole: DataRoleType):
设置指定的端口支持的角色模式,包含充电角色、数据传输角色。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力:** SystemCapability.USB.USBManager
......@@ -712,7 +712,7 @@ USB设备消息传输通道,用于确定设备。
USB设备端口。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力**:SystemCapability.USB.USBManager
......@@ -726,7 +726,7 @@ USB设备端口。
USB设备端口角色信息。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力**:SystemCapability.USB.USBManager
......@@ -776,7 +776,7 @@ USB设备端口角色信息。
USB设备侧功能。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力**:SystemCapability.USB.USBManager
......@@ -797,7 +797,7 @@ USB设备侧功能。
USB端口模式类型。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力**:SystemCapability.USB.USBManager
......@@ -813,7 +813,7 @@ USB端口模式类型。
电源角色类型。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力**:SystemCapability.USB.USBManager
......@@ -827,7 +827,7 @@ USB端口模式类型。
数据角色类型。
此接口为系统接口。
**系统接口:** 此接口为系统接口。
**系统能力**:SystemCapability.USB.USBManager
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册