!7174 翻译完成：6181 Add doc for screen.md

Merge pull request !7174 from wusongqing/TR6181

en/application-dev/reference/apis/js-apis-screen.md

+# Screen
+The **Screen** module implements basic screen management. You can use the APIs of this module to obtain a **Screen** object, listen for screen changes, and create and destroy virtual screens.
+
+> **NOTE**
+>
+> The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+> 
+> The APIs provided by this module are system APIs.
+## Modules to Import
+
+```js
+import screen from '@ohos.screen';
+```
+
+## screen.getAllScreens
+
+getAllScreens(callback: AsyncCallback<Array<Screen>>): void
+
+Obtains all screens. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+
+| Name  | Type                                               | Mandatory| Description                                  |
+| -------- | --------------------------------------------------- | ---- | -------------------------------------- |
+| callback | AsyncCallback<Array<[Screen](#screen)>> | Yes  | Callback used to return all the **Screen** objects obtained.|
+
+**Example**
+
+```js
+var screenClass = null;
+screen.getAllScreens((err, data) => {
+    if (err.code) {
+        console.error('Failed to get all screens . Cause:  ' + JSON.stringify(err));
+        return;
+    }
+    console.info('Succeeded in getting all screens . Data:' + JSON.stringify(data));
+    screenClass = data[0];
+});
+```
+## screen.getAllScreens
+
+getAllScreens(): Promise<Array<Screen>>
+
+Obtains all screens. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Return value**
+| Type                                         | Description                                     |
+| --------------------------------------------- | ----------------------------------------- |
+| Promise<Array<[Screen](#screen)>> | Promise used to return all the **Screen** objects obtained.|
+
+**Example**
+```js
+var screenClass = null;
+let promise = screen.getAllScreens();
+promise.then((data) => {
+    screenClass = data[0];
+    console.log('Succeeded in getting all screens . Data:'+ JSON.stringify(data));
+}).catch((err) => {
+    console.log('Failed to get all screens . Cause: ' + JSON.stringify(err));
+});
+```
+## screen.on('connect' | 'disconnect' | 'change')
+on(eventType: 'connect' | 'disconnect' | 'change', callback: Callback<number>): void
+
+Subscribes to events related to the screen state.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+| Name   | Type                  | Mandatory| Description                                                        |
+| --------- | ---------------------- | ---- | ------------------------------------------------------------ |
+| eventType | string                 | Yes  | Event type.<br>- **connect**: an event indicating that the screen is connected.<br>- **disconnect**: an event indicating that the screen is disconnected.<br>- **change**: an event indicating that the screen state changes.|
+| callback  | Callback&lt;number&gt; | Yes  | Callback used to return the screen ID.                                    |
+
+**Example**
+```js
+var callback = (data) => {
+    console.info('Register the callback for screen changes. Data: ' + JSON.stringify(data))
+};
+screen.on("connect", callback);
+```
+## screen.off('connect' | 'disconnect' | 'change')
+off(eventType: 'connect' | 'disconnect' | 'change', callback?: Callback&lt;number&gt;): void
+
+Unsubscribes from events related to the screen state.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+| Name   | Type                  | Mandatory| Description                                                        |
+| --------- | ---------------------- | ---- | ------------------------------------------------------------ |
+| eventType | string                 | Yes  | Event type.<br>- **connect**: an event indicating that the screen is connected.<br>- **disconnect**: an event indicating that the screen is disconnected.<br>- **change**: an event indicating that the screen state changes.|
+| callback  | Callback&lt;number&gt; | No  | Callback used to return the screen ID.                                    |
+
+**Example**
+```js
+var callback = (data) => {
+    console.info('Unegister the callback for screen changes. Data: ' + JSON.stringify(data))
+};
+screen.off("connect", callback);
+```
+
+## screen.makeExpand
+makeExpand(options:Array&lt;ExpandOption&gt;, callback: AsyncCallback&lt;number&gt;): void
+
+Sets the screen to the expanded mode. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+| Name  | Type                                      | Mandatory| Description                            |
+| -------- | ------------------------------------------ | ---- | -------------------------------- |
+| options  | Array&lt;[ExpandOption](#expandoption)&gt; | Yes  | Parameters for expanding the screen.        |
+| callback | Callback&lt;number&gt;                     | Yes  | Callback used to return the group ID of the expanded screens.|
+
+**Example**
+
+```js
+var groupId = null;
+screen.makeExpand([{screenId: 0, startX: 0, startY: 0}, {screenId: 1, startX: 1080, startY: 0}], (err, data) => {
+  if (err.code) {
+    console.error('Failed to make screens as expand-screen. Cause:' + JSON.stringify(err));
+    return;
+  }
+  groupId = data;
+  console.info('Succeeded in making screens as expand-screen.Data:' + JSON.stringify(data));
+});
+```
+
+## screen.makeExpand
+makeExpand(options:Array&lt;ExpandOption&gt;): Promise&lt;number&gt;
+
+Sets the screen to the expanded mode. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+
+| Name | Type                                      | Mandatory| Description                    |
+| ------- | ------------------------------------------ | ---- | ------------------------ |
+| options | Array&lt;[ExpandOption](#expandoption)&gt; | Yes  | Parameters for expanding the screen.|
+
+**Return value**
+| Type                 | Description                               |
+| --------------------- | ----------------------------------- |
+| Promise&lt;number&gt; | Promise used to return the group ID of the expanded screens.|
+
+**Example**
+```js
+screen.makeExpand([{screenId: 0, startX: 0, startY: 0}, {screenId: 1, startX: 1080, startY: 0}]).then((data) => {
+  console.info('Succeeded in making screens as expand-screen.Data:' + JSON.stringify(data));
+}).catch((err) => {
+  console.error('Failed to make screens as expand-screen. Cause:' + JSON.stringify(err));
+});
+```
+
+## screen.makeMirror
+makeMirror(mainScreen:number, mirrorScreen:Array&lt;number&gt;, callback: AsyncCallback&lt;number&gt;): void
+
+Sets screen mirroring. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+
+| Name      | Type                       | Mandatory| Description             |
+| ------------ | --------------------------- | ---- |-----------------|
+| mainScreen   | number                      | Yes  | ID of the primary screen.         |
+| mirrorScreen | Array&lt;number&gt;         | Yes  | IDs of secondary screens.      |
+| callback     | AsyncCallback&lt;number&gt; | Yes  | Callback used to return the group ID of the secondary screens.|
+
+**Example**
+```js
+var mainScreenId = 0;
+var mirrorScreenIds = [1, 2, 3];
+screen.makeMirror(mainScreenId, mirrorScreenIds, (err, data) => {
+  if (err.code) {
+    console.error('Failed to make screens as mirror-screen.Cause:' + JSON.stringify(err));
+    return;
+  }
+  console.info('Succeeded in making screens as mirror-screen.Data:' + JSON.stringify(data));
+});
+```
+
+## screen.makeMirror
+makeMirror(mainScreen:number, mirrorScreen:Array&lt;number&gt;): Promise&lt;number&gt;
+
+Sets screen mirroring. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+
+| Name      | Type               | Mandatory| Description       |
+| ------------ | ------------------- | ---- |-----------|
+| mainScreen   | number              | Yes  | ID of the primary screen.   |
+| mirrorScreen | Array&lt;number&gt; | Yes  | IDs of secondary screens.|
+
+**Return value**
+| Type                 | Description                               |
+| --------------------- | ----------------------------------- |
+| Promise&lt;number&gt; | Promise used to return the group ID of the secondary screens.|
+
+**Example**
+```js
+var mainScreenId = 0;
+var mirrorScreenIds = [1, 2, 3];
+screen.makeMirror(mainScreenId, mirrorScreenIds).then((data) => {
+  console.info('Succeeded in making screens as mirror-screen.Data:' + JSON.stringify(data));
+}).catch((err) => {
+  console.error('Failed to make screens as mirror-screen.Cause:' + JSON.stringify(err));
+});
+```
+
+## screen.createVirtualScreen
+createVirtualScreen(options:VirtualScreenOption, callback: AsyncCallback&lt;Screen&gt;): void
+
+Creates a virtual screen. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+
+| Name  | Type                                       | Mandatory| Description                              |
+| -------- | ------------------------------------------- | ---- | ---------------------------------- |
+| options  | [VirtualScreenOption](#virtualscreenoption) | Yes  | Virtual screen parameters.          |
+| callback | AsyncCallback&lt;[Screen](#screen)&gt;      | Yes  | Callback used to return the created virtual screen.|
+
+**Example**
+```js
+var screenClass = null;
+screen.createVirtualScreen({
+  name: 'screen01',
+  width: 1080,
+  height: 2340,
+  density: 2,
+  surfaceId: ''
+}, (err, data) => {
+  if (err.code) {
+    console.error('Failed to create virtual screen.Cause:' + JSON.stringify(err));
+    return;
+  }
+  screenClass = data;
+  console.info('Succeeded in creating virtual screen.Data:' + JSON.stringify(data));
+});
+```
+
+## screen.createVirtualScreen
+createVirtualScreen(options:VirtualScreenOption): Promise&lt;Screen&gt;
+
+Creates a virtual screen. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+| Name | Type                                       | Mandatory| Description                    |
+| ------- | ------------------------------------------- | ---- | ------------------------ |
+| options | [VirtualScreenOption](#virtualscreenoption) | Yes  | Virtual screen parameters.|
+
+**Return value**
+
+| Type                            | Description                                 |
+| -------------------------------- | ------------------------------------- |
+| Promise&lt;[Screen](#screen)&gt; | Promise used to return the created virtual screen.|
+
+**Example**
+```js
+var screenClass = null;
+screen.createVirtualScreen({
+  name: 'screen01',
+  width: 1080,
+  height: 2340,
+  density: 2,
+  surfaceId: ''
+}).then((data) => {
+  screenClass = data;
+  console.info('Succeeded in creating virtual screen.Data:' + JSON.stringify(data));
+}).catch((err) => {
+  console.error('Failed to create virtual screen.Cause:' + JSON.stringify(err));
+});
+```
+
+## screen.destroyVirtualScreen
+destroyVirtualScreen(screenId:number, callback: AsyncCallback&lt;void&gt;): void
+
+Destroys a virtual screen. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+| Name  | Type                     | Mandatory| Description                                                        |
+| -------- | ------------------------- | ---- | ------------------------------------------------------------ |
+| screenId | number                    | Yes  | Screen ID.                                                  |
+| callback | AsyncCallback&lt;void&gt; | Yes  | Callback used to return the result. If the virtual screen is destroyed, **err** is **undefined**; otherwise, **err** is an error object.|
+
+**Example**
+```js
+var screenId = 1;
+screen.destroyVirtualScreen(screenId, (err,data) => {
+  if (err.code) {
+    console.error('Failed to destroy virtual screen.Cause:' + JSON.stringify(err));
+    return;
+  }
+  console.info('Succeeded in destroying virtual screen.');
+});
+```
+
+## screen.destroyVirtualScreen
+destroyVirtualScreen(screenId:number): Promise&lt;void&gt;
+
+Destroys a virtual screen. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+| Name  | Type  | Mandatory| Description      |
+| -------- | ------ | ---- | ---------- |
+| screenId | number | Yes  | Screen ID.|
+
+**Return value**
+| Type               | Description                     |
+| ------------------- | ------------------------- |
+| Promise&lt;void&gt; | Promise that returns no value.|
+
+**Example**
+```js
+var screenId = 1;
+screen.destroyVirtualScreen(screenId).then((data) => {
+  console.info('Succeeded in destroying virtual screen.');
+}).catch((err) => {
+  console.error('Failed to destroy virtual screen.Cause:' + JSON.stringify(err));
+});
+```
+
+## screen.setVirtualScreenSurface
+setVirtualScreenSurface(screenId:number, surfaceId: string, callback: AsyncCallback&lt;void&gt;): void
+
+Sets the surface for a virtual screen. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+
+| Name   | Type                     | Mandatory| Description                                                        |
+| --------- | ------------------------- | ---- | ------------------------------------------------------------ |
+| screenId  | number                    | Yes  | Screen ID.                                                  |
+| surfaceId | string                    | Yes  | Surface ID.                                               |
+| callback  | AsyncCallback&lt;void&gt; | Yes  | Callback used to return the result. If the virtual screen surface is successfully set, **err** is **undefined**; otherwise, **err** is an error object.|
+
+**Example**
+
+```js
+var screenId = 1;
+var surfaceId = '2048';
+screen.setVirtualScreenSurface(screenId, surfaceId, (err,data) => {
+  if (err.code) {
+    console.error('Failed to set surface for the virtual screen. Cause:' + JSON.stringify(err));
+    return;
+  }
+  console.info('Succeeded in setting surface for the virtual screen.');
+});
+```
+
+## screen.setVirtualScreenSurface
+setVirtualScreenSurface(screenId:number, surfaceId: string): Promise&lt;void&gt;
+
+Sets the surface for a virtual screen. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+| Name   | Type  | Mandatory| Description         |
+| --------- | ------ | ---- | ------------- |
+| screenId  | number | Yes  | Screen ID.   |
+| surfaceId | string | Yes  | Surface ID.|
+
+**Return value**
+| Type               | Description                     |
+| ------------------- | ------------------------- |
+| Promise&lt;void&gt; | Promise that returns no value.|
+
+**Example**
+```js
+var screenId = 1;
+var surfaceId = '2048';
+screen.setVirtualScreenSurface(screenId, surfaceId).then((data) => {
+  console.info('Succeeded in setting surface for the virtual screen.');
+}).catch((err) => {
+  console.error('Failed to set surface for the virtual screen. Cause:' + JSON.stringify(err));
+});
+```
+
+## screen.isScreenRotationLocked
+isScreenRotationLocked(): Promise&lt;boolean&gt;
+
+Checks whether auto rotate is locked. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Return value**
+| Type                  | Description                                 |
+| ---------------------- | ------------------------------------- |
+| Promise&lt;boolean&gt; | Promise used to return the result. If **true** is returned, auto rotate is locked. If **false** is returned, auto rotate is unlocked.|
+
+**Example**
+```js
+screen.isScreenRotationLocked().then((isLocked) => {
+  console.info('Succeeded in getting screen rotation lock status. isLocked:'+ JSON.stringify(isLocked));
+}).catch((err) => {
+  console.error('Failed to get screen rotation lock status. Cause:' + JSON.stringify(err));
+});
+```
+
+## screen.isScreenRotationLocked
+isScreenRotationLocked(callback: AsyncCallback&lt;boolean&gt;): void
+
+Checks whether auto rotate is locked. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+
+| Name   | Type                         | Mandatory| Description                                                        |
+| --------- | ---------------------------- | ---- | ------------------------------------------------------------ |
+| callback  | AsyncCallback&lt;boolean&gt; | Yes  | Callback used to return the result. If **true** is returned, auto rotate is locked. If **false** is returned, auto rotate is unlocked.|
+
+**Example**
+
+```js
+screen.isScreenRotationLocked((err, isLocked) => {
+  if (err.code) {
+    console.error('Failed to get screen rotation lock status. Cause:' + JSON.stringify(err));
+    return;
+  }
+  console.info('Succeeded in getting screen rotation lock status. isLocked:' + JSON.stringify(isLocked));
+});
+```
+
+## screen.setScreenRotationLocked
+setScreenRotationLocked(isLocked: boolean): Promise&lt;void&gt;
+
+Sets whether to lock auto rotate. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+| Name   | Type  | Mandatory| Description         |
+| --------- | ------ | ---- | ------------- |
+| isLocked  | boolean | Yes  | Whether to lock auto rotate. The value **true** means to lock auto rotate, and **false** means the opposite.|
+
+**Return value**
+| Type               | Description                     |
+| ------------------- | ------------------------- |
+| Promise&lt;void&gt; | Promise that returns no value.|
+
+**Example**
+```js
+var isLocked = false;
+screen.setScreenRotationLocked(isLocked).then((data) => {
+  console.info('Succeeded in setting whether to lock screen rotation');
+}).catch((err) => {
+  console.error('Failed to set whether to lock screen rotation. Cause:' + JSON.stringify(err));
+});
+```
+
+## screen.setScreenRotationLocked
+setScreenRotationLocked(isLocked: boolean, callback: AsyncCallback&lt;void&gt;): void
+
+Sets whether to lock auto rotate. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+**Parameters**
+
+| Name   | Type                     | Mandatory| Description                                                        |
+| --------- | ------------------------- | ---- | ------------------------------------------------------------ |
+| isLocked  | boolean                   | Yes  | Whether to lock auto rotate. The value **true** means to lock auto rotate, and **false** means the opposite.                |
+| callback  | AsyncCallback&lt;void&gt; | Yes  | Callback used to return the result. If the operation is successful, **err** is **undefined**; otherwise, **err** is an error object.|
+
+**Example**
+
+```js
+var isLocked = false;
+screen.setScreenRotationLocked(isLocked, (err, data) => {
+  if (err.code) {
+    console.error('Failed to set whether to lock screen rotation. Cause:' + JSON.stringify(err));
+    return;
+  }
+  console.info('Succeeded in setting whether to lock screen rotation.');
+});
+```
+
+## ExpandOption
+Defines the parameters for expanding a screen.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+| Name    | Type| Readable| Writable| Description               |
+| -------- | -------- | ---- | ---- | ------------------- |
+| screenId | number   | Yes  | Yes  | Screen ID.         |
+| startX   | number   | Yes  | Yes  | Start X coordinate of the screen.|
+| startY   | number   | Yes  | Yes  | Start Y coordinate of the screen.|
+
+## VirtualScreenOption
+Defines virtual screen parameters.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+| Name     | Type| Readable| Writable| Description                     |
+| --------- | -------- | ---- | ---- | ------------------------- |
+| name      | string   | Yes  | Yes  | Name of a virtual screen.     |
+| width     | number   | Yes  | Yes  | Width of the virtual screen.     |
+| height    | number   | Yes  | Yes  | Height of the virtual screen.     |
+| density   | number   | Yes  | Yes  | Density of the virtual screen.     |
+| surfaceId | string   | Yes  | Yes  | Surface ID of the virtual screen.|
+
+## Screen
+Implements a **Screen** instance.
+
+Before calling any API in **Screen**, you must use **[getAllScreens()](#screengetallscreens)** or **[createVirtualScreen()](#screencreatevirtualscreen)** to obtain a **Screen** instance.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+| Name             | Type                                      | Readable| Writable| Description                  |
+| ----------------- | ---------------------------------------------- | ---- | ---- | ---------------------- |
+| id                | number                                         | Yes  | No  | Screen ID.            |
+| parent            | number                                         | Yes  | No  | ID of the group to which a screen belongs.    |
+| supportedModeInfo | Array&lt;[ScreenModeInfo](#screenmodeinfo)&gt; | Yes  | No  | Mode set supported by the screen.  |
+| activeModeIndex   | number                                         | Yes  | No  | Index of the active screen mode.|
+| orientation       | [Orientation](#orientation)                     | Yes  | No  | Screen orientation.            |
+
+### setOrientation
+setOrientation(orientation: Orientation, callback: AsyncCallback&lt;void&gt;): void
+
+Sets the screen orientation. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+| Name     | Type                       | Mandatory| Description                                                        |
+| ----------- | --------------------------- | ---- | ------------------------------------------------------------ |
+| orientation | [Orientation](#orientation) | Yes  | Screen orientation.                                                  |
+| callback    | AsyncCallback&lt;void&gt;   | Yes  | Callback used to return the result. If the screen orientation is successfully set, **err** is **undefined**; otherwise, **err** is an error object.|
+
+**Example**
+```js
+screenClass.setOrientation(screen.Orientation.VERTICAL, (err, data) => {
+    if (err.code) {
+        console.error('Failed to setOrientation VERTICAL. Cause: ' + JSON.stringify(err));
+        return;
+    }
+    console.info('Succeeded in setting Orientation VERTICAL. data: ' + JSON.stringify(data));
+})
+```
+### setOrientation
+setOrientation(orientation: Orientation): Promise&lt;void&gt;
+
+Sets the screen orientation. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+| Name     | Type                       | Mandatory| Description      |
+| ----------- | --------------------------- | ---- | ---------- |
+| orientation | [Orientation](#orientation) | Yes  | Screen orientation.|
+
+**Return value**
+| Type               | Description                     |
+| ------------------- | ------------------------- |
+| Promise&lt;void&gt; | Promise that returns no value.|
+
+**Example**
+```js
+let promise = screenClass.setOrientation(screen.Orientation.VERTICAL);
+promise.then((data) => {
+    console.info('Succeeded in setting Orientation VERTICAL. Data: ' + JSON.stringify(data));
+}).catch((err) => {
+    console.error('Failed to set Orientation VERTICAL. Cause: ' + JSON.stringify(err));
+})
+```
+### setScreenActiveMode
+setScreenActiveMode(modeIndex: number, callback: AsyncCallback&lt;void&gt;): void
+
+Sets the active mode of the screen. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+| Name   | Type                     | Mandatory| Description                                                        |
+| --------- | ------------------------- | ---- | ------------------------------------------------------------ |
+| modeIndex | number                    | Yes  | Index of the mode to set.                                                  |
+| callback  | AsyncCallback&lt;void&gt; | Yes  | Callback used to return the result. If the active mode is successfully set, **err** is **undefined**; otherwise, **err** is an error object.|
+
+**Example**
+
+```js
+var modeIndex = 0;
+screenClass.setScreenActiveMode(modeIndex, (err, data) => {
+    if (err.code) {
+        console.error('Failed to set ScreenActiveMode 0. Cause: ' + JSON.stringify(err));
+        return;
+    }
+    console.info('Succeeded in setting ScreenActiveMode 0. data: ' + JSON.stringify(data));
+})
+```
+### setScreenActiveMode
+setScreenActiveMode(modeIndex: number): Promise&lt;void&gt;
+
+Sets the active mode of the screen. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+| Name   | Type  | Mandatory| Description      |
+| --------- | ------ | ---- | ---------- |
+| modeIndex | number | Yes  | Index of the mode to set.|
+
+**Return value**
+
+| Type               | Description                     |
+| ------------------- | ------------------------- |
+| Promise&lt;void&gt; | Promise that returns no value.|
+
+**Example**
+```js
+var modeIndex = 0;
+let promise = screenClass.setScreenActiveMode(modeIndex);
+promise.then((data) => {
+    console.info('Succeeded in setting ScreenActiveMode 0. Data: ' + JSON.stringify(data));
+}).catch((err) => {
+    console.error('Failed to set ScreenActiveMode 0. Cause: ' + JSON.stringify(err));
+})
+```
+
+### setDensityDpi
+setDensityDpi(densityDpi: number, callback: AsyncCallback&lt;void&gt;): void;
+
+Sets the pixel density of the screen. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+| Name    | Type                     | Mandatory| Description                                                        |
+| ---------- | ------------------------- | ---- | ------------------------------------------------------------ |
+| densityDpi | number                    | Yes  | Pixel density. The value ranges from 80 to 640.                          |
+| callback   | AsyncCallback&lt;void&gt; | Yes  | Callback used to return the result. If the pixel density is successfully set, **err** is **undefined**; otherwise, **err** is an error object.|
+
+**Example**
+```js
+var densityDpi = 320;
+screenClass.setDensityDpi(densityDpi, (err, data) => {
+    if (err.code) {
+        console.error('Failed to set DensityDpi 320. Cause: ' + JSON.stringify(err));
+        return;
+    }
+    console.info('Succeed in setting DensityDpi 320. data: ' + JSON.stringify(data));
+})
+```
+
+### setDensityDpi
+setDensityDpi(densityDpi: number): Promise&lt;void&gt;
+
+Sets the pixel density of the screen. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+| Name    | Type  | Mandatory| Description                              |
+| ---------- | ------ | ---- | ---------------------------------- |
+| densityDpi | number | Yes  | Pixel density. The value ranges from 80 to 640.|
+
+**Return value**
+
+| Type               | Description                     |
+| ------------------- | ------------------------- |
+| Promise&lt;void&gt; | Promise that returns no value.|
+
+**Example**
+```js
+var densityDpi = 320;
+var promise = screenClass.setDensityDpi(densityDpi);
+promise.then((data) => {
+    console.info('Succeeded in setting DensityDpi 320. Data: ' + JSON.stringify(data));
+}).catch((err) => {
+    console.error('Failed to set DensityDpi 320. Cause: ' + JSON.stringify(err));
+})
+```
+
+## Orientation
+Enumerates the screen orientations.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+| Name              | Value  | Description                            |
+| ------------------ | ---- | -------------------------------- |
+| UNSPECIFIED        | 0    | Unspecified. The screen orientation is determined by the system.|
+| VERTICAL           | 1    | Vertical.        |
+| HORIZONTAL         | 2    | Horizontal.        |
+| REVERSE_VERTICAL   | 3    | Reverse vertical.    |
+| REVERSE_HORIZONTAL | 4    | Reverse horizontal.    |
+| SENSOR             | 5    | The screen orientation follows the sensor direction.    |
+| SENSOR_VERTICAL    | 6    | The screen orientation follows the sensor direction vertically.|
+| SENSOR_HORIZONTAL  | 7    | The screen orientation follows the sensor direction horizontally.|
+
+## ScreenModeInfo
+Defines the screen mode information.
+
+**System capability**: SystemCapability.WindowManager.WindowManager.Core
+
+| Name       | Type| Readable| Writable| Description                                              |
+| ----------- | -------- | ---- | ---- | -------------------------------------------------- |
+| id          | number   | Yes  | Yes  | Mode ID. The supported mode is determined by the device resolution and refresh rate.|
+| width       | number   | Yes  | Yes  | Screen width.                                      |
+| height      | number   | Yes  | Yes  | Screen height.                                      |
+| refreshRate | number   | Yes  | Yes  | Screen refresh rate.                                    |