harmony 鸿蒙@ohos.display (Display)
@ohos.display (Display)
The Display module provides APIs for managing displays, such as obtaining information about the default display, obtaining information about all displays, and listening for the addition and removal of displays.
NOTE
The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
Modules to Import
import display from '@ohos.display';
DisplayState
Enumerates the display states.
System capability: SystemCapability.WindowManager.WindowManager.Core
Name | Value | Description |
---|---|---|
STATE_UNKNOWN | 0 | Unknown. |
STATE_OFF | 1 | The display is shut down. |
STATE_ON | 2 | The display is powered on. |
STATE_DOZE | 3 | The display is in sleep mode. |
STATE_DOZE_SUSPEND | 4 | The display is in sleep mode, and the CPU is suspended. |
STATE_VR | 5 | The display is in VR mode. |
STATE_ON_SUSPEND | 6 | The display is powered on, and the CPU is suspended. |
Orientation10+
Enumerates the orientations of the display.
System capability: SystemCapability.WindowManager.WindowManager.Core
Name | Value | Description |
---|---|---|
PORTRAIT | 0 | The display is in portrait mode. |
LANDSCAPE | 1 | The display is in landscape mode. |
PORTRAIT_INVERTED | 2 | The display is in reverse portrait mode. |
LANDSCAPE_INVERTED | 3 | The display is in reverse landscape mode. |
FoldStatus10+
Enumerates the folding statuses of a foldable device.
System capability: SystemCapability.Window.SessionManager
Name | Value | Description |
---|---|---|
FOLD_STATUS_UNKNOWN | 0 | The folding status of the device is unknown. |
FOLD_STATUS_EXPANDED | 1 | The device is fully open. |
FOLD_STATUS_FOLDED | 2 | The device is folded (completely closed). |
FOLD_STATUS_HALF_FOLDED | 3 | The device is half-folded, somehow between fully open and completely closed. |
FoldDisplayMode10+
Enumerates the display modes of a foldable device.
System capability: SystemCapability.Window.SessionManager
Name | Value | Description |
---|---|---|
FOLD_DISPLAY_MODE_UNKNOWN | 0 | The display mode of the device is unknown. |
FOLD_DISPLAY_MODE_FULL | 1 | The device is displayed in full screen. |
FOLD_DISPLAY_MODE_MAIN | 2 | The main screen of the device is displayed. |
FOLD_DISPLAY_MODE_SUB | 3 | The subscreen of the device is displayed. |
FOLD_DISPLAY_MODE_COORDINATION | 4 | Both screens of the device are displayed in collaborative mode. |
FoldCreaseRegion10+
Defines the crease region of a foldable device.
System capability: SystemCapability.Window.SessionManager
Name | Type | Readable | Writable | Description |
---|---|---|---|---|
displayId | number | Yes | No | ID of the screen where the crease is located. |
creaseRects | Array<Rect> | Yes | No | Crease region. |
Rect9+
Describes a rectangle on the display.
System capability: SystemCapability.WindowManager.WindowManager.Core
Name | Type | Readable | Writable | Description |
---|---|---|---|---|
left | number | Yes | Yes | Left boundary of the rectangle, in pixels. The value must be an integer. |
top | number | Yes | Yes | Top boundary of the rectangle, in pixels. The value must be an integer. |
width | number | Yes | Yes | Width of the rectangle, in pixels. The value must be an integer. |
height | number | Yes | Yes | Height of the rectangle, in pixels. The value must be an integer. |
WaterfallDisplayAreaRects9+
Describes the curved area (an area that is not intended for displaying content) on the waterfall display.
System capability: SystemCapability.WindowManager.WindowManager.Core
Name | Type | Readable | Writable | Description |
---|---|---|---|---|
left | Rect | Yes | No | Bounding rectangle for the curved area, which is located on the left of the display surface. |
top | Rect | Yes | No | Bounding rectangle for the curved area, which is located at the top of the display surface. |
right | Rect | Yes | No | Bounding rectangle for the curved area, which is located on the right of the display surface. |
bottom | Rect | Yes | No | Bounding rectangle for the curved area, which is located at the bottom of the display surface. |
CutoutInfo9+
Describes the cutout, which is an area that is not intended for displaying content on the display.
System capability: SystemCapability.WindowManager.WindowManager.Core
Name | Type | Readable | Writable | Description |
---|---|---|---|---|
boundingRects | Array<Rect> | Yes | No | Bounding rectangle for punch holes and notches. |
waterfallDisplayAreaRects | WaterfallDisplayAreaRects | Yes | No | Curved area on the waterfall display. |
display.getDefaultDisplaySync9+
getDefaultDisplaySync(): Display
Obtains the default display object. This API returns the result synchronously.
System capability: SystemCapability.WindowManager.WindowManager.Core
Return value
Type | Description |
---|---|
Display | Default display object. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400001 | Invalid display or screen. |
Example
import display from '@ohos.display';
let displayClass: display.Display|null = null;
try {
displayClass = display.getDefaultDisplaySync();
} catch (exception) {
console.error('Failed to obtain the default display object. Code: ' + JSON.stringify(exception));
}
display.getAllDisplays9+
getAllDisplays(callback: AsyncCallback<Array<Display>>): void
Obtains all display objects. This API uses an asynchronous callback to return the result.
System capability: SystemCapability.WindowManager.WindowManager.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
callback | AsyncCallback<Array<Display>> | Yes | Callback used to return all the display objects. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400001 | Invalid display or screen. |
Example
import { BusinessError } from '@ohos.base';
import display from '@ohos.display';
let displayClass: Array<display.Display> = [];
display.getAllDisplays((err: BusinessError, data: Array<display.Display>) => {
displayClass = data;
const errCode: number = err.code;
if (errCode) {
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.getAllDisplays9+
getAllDisplays(): Promise<Array<Display>>
Obtains all display objects. This API uses a promise to return the result.
System capability: SystemCapability.WindowManager.WindowManager.Core
Return value
Type | Description |
---|---|
Promise<Array<Display>> | Promise used to return all the display objects. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400001 | Invalid display or screen. |
Example
import { BusinessError } from '@ohos.base';
import display from '@ohos.display';
let displayClass: Array<display.Display> =[];
let promise: Promise<Array<display.Display>> = display.getAllDisplays();
promise.then((data: Array<display.Display>) => {
displayClass = data;
console.info('Succeeded in obtaining all the display objects. Data: ' + JSON.stringify(data));
}).catch((err: BusinessError) => {
console.error('Failed to obtain all the display objects. Code: ' + JSON.stringify(err));
});
display.hasPrivateWindow9+
hasPrivateWindow(displayId: number): boolean
Checks whether there is a visible privacy window on a display. The privacy window can be set by calling setWindowPrivacyMode(). The content in the privacy window cannot be captured or recorded.
System API: This is a system API.
System capability: SystemCapability.WindowManager.WindowManager.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
id | number | Yes | ID of the display. The value must be an integer. |
Return value
Type | Description |
---|---|
boolean | Whether there is a visible privacy window on the display. The value true means that there is a visible privacy window on the display, and false means the opposite. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400003 | This display manager service works abnormally. |
Example
import display from '@ohos.display';
let displayClass: display.Display|null = null;
try {
displayClass = display.getDefaultDisplaySync();
let ret: boolean = true;
try {
ret = display.hasPrivateWindow(displayClass.id);
} catch (exception) {
console.error('Failed to check has privateWindow or not. Code: ' + JSON.stringify(exception));
}
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.");
}
} catch (exception) {
console.error('Failed to obtain the default display object. Code: ' + JSON.stringify(exception));
}
display.on(‘add’|‘remove’|‘change’)
on(type: ‘add’|‘remove’|‘change’, callback: Callback<number>): void
Subscribes to display changes.
System capability: SystemCapability.WindowManager.WindowManager.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. - add, indicating the display addition event. Example: event that a display is connected. - remove, indicating the display removal event. Example: event that a display is disconnected. - change, indicating the display change event. Example: event that the display orientation is changed. |
callback | Callback<number> | Yes | Callback used to return the ID of the display, which is an integer. |
Example
import { Callback } from '@ohos.base';
let callback: Callback<number> = (data: number) => {
console.info('Listening enabled. Data: ' + JSON.stringify(data));
};
try {
display.on("add", callback);
} catch (exception) {
console.error('Failed to register callback. Code: ' + JSON.stringify(exception));
}
display.off(‘add’|‘remove’|‘change’)
off(type: ‘add’|‘remove’|‘change’, callback?: Callback<number>): void
Unsubscribes from display changes.
System capability: SystemCapability.WindowManager.WindowManager.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. - add, indicating the display addition event. Example: event that a display is connected. - remove, indicating the display removal event. Example: event that a display is disconnected. - change, indicating the display change event. Example: event that the display orientation is changed. |
callback | Callback<number> | No | Callback used to return the ID of the display, which is an integer. |
Example
try {
display.off("remove");
} catch (exception) {
console.error('Failed to unregister callback. Code: ' + JSON.stringify(exception));
}
display.on(‘privateModeChange’)10+
on(type: ‘privateModeChange’, callback: Callback<boolean>): void
Subscribes to privacy mode changes of this display. When there is a privacy window in the foreground of the display, the display is in privacy mode, and the content in the privacy window cannot be captured or recorded.
System API: This is a system API.
System capability: SystemCapability.WindowManager.WindowManager.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is fixed at ‘privateModeChange’, indicating the event of display privacy mode changes. |
callback | Callback<boolean> | Yes | Callback used to return whether the privacy mode of the display is changed. The value true means that the display changes to the privacy mode, and false means the opposite. |
Example
import { Callback } from '@ohos.base';
let callback: Callback<boolean> = (data: boolean) => {
console.info('Listening enabled. Data: ' + JSON.stringify(data));
};
try {
display.on("privateModeChange", callback);
} catch (exception) {
console.error('Failed to register callback. Code: ' + JSON.stringify(exception));
}
display.off(‘privateModeChange’)10+
off(type: ‘privateModeChange’, callback?: Callback<boolean>): void
Unsubscribes from privacy mode changes of this display. When there is a privacy window in the foreground of the display, the display is in privacy mode, and the content in the privacy window cannot be captured or recorded.
System API: This is a system API.
System capability: SystemCapability.WindowManager.WindowManager.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The value is fixed at ‘privateModeChange’, indicating the event of display privacy mode changes. |
callback | Callback<boolean> | No | Callback used to return whether the privacy mode of the display is changed. The value true means that the display changes to the privacy mode, and false means the opposite. |
Example
try {
display.off("privateModeChange");
} catch (exception) {
console.error('Failed to unregister callback. Code: ' + JSON.stringify(exception));
}
display.isFoldable10+
isFoldable(): boolean
Checks whether the device is foldable.
System capability: SystemCapability.Window.SessionManager
Return value
Type | Description |
---|---|
boolean | Returns true if the device is foldable, and returns false otherwise. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400003 | This display manager service works abnormally. |
Example
import display from '@ohos.display';
let displayClass: display.Display|null = null;
try {
displayClass = display.getDefaultDisplaySync();
let ret: boolean = false;
try {
ret = display.isFoldable();
} catch (exception) {
console.error('Failed to check is foldable or not. Code: ' + JSON.stringify(exception));
}
if (ret == undefined) {
console.log("Failed to check is foldable or not.");
}
if (ret) {
console.log("The device is foldable.");
} else if (!ret) {
console.log("The device is not foldable.");
}
} catch (exception) {
console.error('Failed to obtain the default display object. Code: ' + JSON.stringify(exception));
}
display.setFoldDisplayMode10+
setFoldDisplayMode(mode: FoldDisplayMode): void
Sets the display mode of the foldable device.
System API: This is a system API.
System capability: SystemCapability.Window.SessionManager
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
mode | FoldDisplayMode | Yes | Display mode. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400003 | This display manager service works abnormally. |
Example
import display from '@ohos.display';
try {
let mode: display.FoldDisplayMode = display.FoldDisplayMode.FOLD_DISPLAY_MODE_FULL;
display.setFoldDisplayMode(mode);
} catch (exception) {
console.error('Failed to change the fold display mode. Code: ' + JSON.stringify(exception));
}
display.getFoldStatus10+
getFoldStatus(): FoldStatus
Obtains the folding status of the foldable device.
System capability: SystemCapability.Window.SessionManager
Return value
Type | Description |
---|---|
FoldStatus | Folding status of the device. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400003 | This display manager service works abnormally. |
Example
import display from '@ohos.display';
try {
display.getFoldStatus();
} catch (exception) {
console.error('Failed to obtain the fold status. Code: ' + JSON.stringify(exception));
}
display.getFoldDisplayMode10+
getFoldDisplayMode(): FoldDisplayMode
Obtains the display mode of the foldable device.
System capability: SystemCapability.Window.SessionManager
Return value
Type | Description |
---|---|
FoldDisplayMode | Display mode of the device. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400003 | This display manager service works abnormally. |
Example
import display from '@ohos.display';
try {
display.getFoldDisplayMode();
} catch (exception) {
console.error('Failed to obtain the fold display mode. Code: ' + JSON.stringify(exception));
}
display.getCurrentFoldCreaseRegion10+
getCurrentFoldCreaseRegion(): FoldCreaseRegion
Obtains the crease region of the foldable device in the current display mode.
System capability: SystemCapability.Window.SessionManager
Return value
Type | Description |
---|---|
FoldCreaseRegion | Crease region of the device. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400003 | This display manager service works abnormally. |
Example
import display from '@ohos.display';
try {
display.getCurrentFoldCreaseRegion();
} catch (exception) {
console.error('Failed to obtain the current fold crease region. Code: ' + JSON.stringify(exception));
}
display.on(‘foldStatusChange’)10+
on(type: ‘foldStatusChange’, callback: Callback<FoldStatus>): void
Subscribes to folding status change events of the foldable device.
System capability: SystemCapability.Window.SessionManager
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The event ‘foldStatusChange’ indicates that the folding status of the device changes. |
callback | Callback<FoldStatus> | Yes | Callback used to return the folding status. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400003 | This display manager service works abnormally. |
Example
import { Callback } from '@ohos.base';
let callback: Callback<display.FoldStatus> = (data: display.FoldStatus) => {
console.info('Listening enabled. Data: ' + JSON.stringify(data));
};
try {
display.on('foldStatusChange', callback);
} catch (exception) {
console.error('Failed to register callback. Code: ' + JSON.stringify(exception));
}
display.off(‘foldStatusChange’)10+
off(type: ‘foldStatusChange’, callback?: Callback<FoldStatus>): void
Unsubscribes from folding status change events of the foldable device.
System capability: SystemCapability.Window.SessionManager
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The event ‘foldStatusChange’ is triggered when the folding status of the device changes. |
callback | Callback<FoldStatus> | No | Callback used to return the folding status. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400003 | This display manager service works abnormally. |
Example
try {
display.off('foldStatusChange');
} catch (exception) {
console.error('Failed to unregister callback. Code: ' + JSON.stringify(exception));
}
display.on(‘foldDisplayModeChange’)10+
on(type: ‘foldDisplayModeChange’, callback: Callback<FoldDisplayMode>): void
Subscribes to display mode change events of the foldable device.
System capability: SystemCapability.Window.SessionManager
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The event ‘foldDisplayModeChange’ is triggered when the display mode of the device changes. |
callback | Callback<FoldDisplayMode> | Yes | Callback used to return the display mode. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400003 | This display manager service works abnormally. |
Example
import { Callback } from '@ohos.base';
let callback: Callback<display.FoldDisplayMode> = (data: display.FoldDisplayMode) => {
console.info('Listening enabled. Data: ' + JSON.stringify(data));
};
try {
display.on('foldDisplayModeChange', callback);
} catch (exception) {
console.error('Failed to register callback. Code: ' + JSON.stringify(exception));
}
display.off(‘foldDisplayModeChange’)10+
off(type: ‘foldDisplayModeChange’, callback?: Callback<FoldDisplayMode>): void
Unsubscribes from display mode change events of the foldable device.
System capability: SystemCapability.Window.SessionManager
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
type | string | Yes | Event type. The event ‘foldDisplayModeChange’ is triggered when the display mode of the device changes. |
callback | Callback<FoldDisplayMode> | No | Callback used to return the display mode. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400003 | This display manager service works abnormally. |
Example
try {
display.off('foldDisplayModeChange');
} catch (exception) {
console.error('Failed to unregister callback. Code: ' + JSON.stringify(exception));
}
display.getDefaultDisplay(deprecated)
getDefaultDisplay(callback: AsyncCallback<Display>): void
Obtains the default display object. This API uses an asynchronous callback to return the result.
NOTE
This API is supported since API version 7 and deprecated since API version 9. You are advised to use getDefaultDisplaySync() instead.
System capability: SystemCapability.WindowManager.WindowManager.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
callback | AsyncCallback<Display> | Yes | Callback used to return the default display object. |
Example
import { BusinessError } from '@ohos.base';
let displayClass: display.Display|null = null;
display.getDefaultDisplay((err: BusinessError, data: display.Display) => {
const errCode: number = err.code;
if (errCode) {
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(deprecated)
getDefaultDisplay(): Promise<Display>
Obtains the default display object. This API uses a promise to return the result.
NOTE
This API is supported since API version 7 and deprecated since API version 9. You are advised to use getDefaultDisplaySync() instead.
System capability: SystemCapability.WindowManager.WindowManager.Core
Return value
Type | Description |
---|---|
Promise<Display> | Promise used to return the default display object. |
Example
import { BusinessError } from '@ohos.base';
let displayClass: display.Display|null = null;
let promise: Promise<display.Display> = display.getDefaultDisplay();
promise.then((data: display.Display) => {
displayClass = data;
console.info('Succeeded in obtaining the default display object. Data:' + JSON.stringify(data));
}).catch((err: BusinessError) => {
console.error('Failed to obtain the default display object. Code: ' + JSON.stringify(err));
});
display.getAllDisplay(deprecated)
getAllDisplay(callback: AsyncCallback<Array<Display>>): void
Obtains all display objects. This API uses an asynchronous callback to return the result.
NOTE
This API is supported since API version 7 and deprecated since API version 9. You are advised to use getAllDisplays() instead.
System capability: SystemCapability.WindowManager.WindowManager.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
callback | AsyncCallback<Array<Display>> | Yes | Callback used to return all the display objects. |
Example
import { BusinessError } from '@ohos.base';
display.getAllDisplay((err: BusinessError, data: Array<display.Display>) => {
const errCode: number = err.code;
if (errCode) {
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(deprecated)
getAllDisplay(): Promise<Array<Display>>
Obtains all display objects. This API uses a promise to return the result.
NOTE
This API is supported since API version 7 and deprecated since API version 9. You are advised to use getAllDisplays() instead.
System capability: SystemCapability.WindowManager.WindowManager.Core
Return value
Type | Description |
---|---|
Promise<Array<Display>> | Promise used to return all the display objects. |
Example
import { BusinessError } from '@ohos.base';
let promise: Promise<Array<display.Display>> = display.getAllDisplay();
promise.then((data: Array<display.Display>) => {
console.info('Succeeded in obtaining all the display objects. Data: ' + JSON.stringify(data));
}).catch((err: BusinessError) => {
console.error('Failed to obtain all the display objects. Code: ' + JSON.stringify(err));
});
Display
Implements a Display instance, with properties and APIs defined.
Before calling any API in Display, you must use getAllDisplays() or getDefaultDisplaySync() to obtain a Display instance.
Attributes
System capability: SystemCapability.WindowManager.WindowManager.Core
Name | Type | Readable | Writable | Description |
---|---|---|---|---|
id | number | Yes | No | ID of the display. The value must be an integer. |
name | string | Yes | No | Name of the display. |
alive | boolean | Yes | No | Whether the display is alive. |
state | DisplayState | Yes | No | State of the display. |
refreshRate | number | Yes | No | Refresh rate of the display. The value must be an integer. |
rotation | number | Yes | No | Screen rotation angle of the display. The value 0 indicates that the screen of the display rotates by 0°. The value 1 indicates that the screen of the display rotates by 90°. The value 2 indicates that the screen of the display rotates by 180°. The value 3 indicates that the screen of the display rotates by 270°. |
width | number | Yes | No | Width of the display, in pixels. The value must be an integer. |
height | number | Yes | No | Height of the display, in pixels. The value must be an integer. |
densityDPI | number | Yes | No | Screen density of the display, that is, the number of dots per inch. The value must be a floating point number. Generally, the value is 160.0 or 480.0. |
orientation10+ | Orientation | Yes | No | Orientation of the display. |
densityPixels | number | Yes | No | Logical density of the display, which is a scaling coefficient independent of the pixel unit. The value must be a floating point number. Generally, the value is 1.0 or 3.0. |
scaledDensity | number | Yes | No | Scaling factor for fonts displayed on the display. The value must be a floating point number. Generally, the value is the same as that of densityPixels. |
xDPI | number | Yes | No | Exact physical dots per inch of the screen in the horizontal direction. The value must be a floating point number. |
yDPI | number | Yes | No | Exact physical dots per inch of the screen in the vertical direction. The value must be a floating point number. |
getCutoutInfo9+
getCutoutInfo(callback: AsyncCallback<CutoutInfo>): void
Obtains the cutout information of the display. This API uses an asynchronous callback to return the result. You are advised not to use the cutout area during application layout.
System capability: SystemCapability.WindowManager.WindowManager.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
callback | AsyncCallback<CutoutInfo> | Yes | Callback used to return the CutoutInfo object. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400001 | Invalid display or screen. |
Example
import { BusinessError } from '@ohos.base';
let displayClass: display.Display|null = null;
try {
displayClass = display.getDefaultDisplaySync();
displayClass.getCutoutInfo((err: BusinessError, data: display.CutoutInfo) => {
const errCode: number = err.code;
if (errCode) {
console.error('Failed to get cutoutInfo. Code: ' + JSON.stringify(err));
return;
}
console.info('Succeeded in getting cutoutInfo. data: ' + JSON.stringify(data));
});
} catch (exception) {
console.error('Failed to obtain the default display object. Code: ' + JSON.stringify(exception));
}
getCutoutInfo9+
getCutoutInfo(): Promise<CutoutInfo>
Obtains the cutout information of the display. This API uses a promise to return the result. You are advised not to use the cutout area during application layout.
System capability: SystemCapability.WindowManager.WindowManager.Core
Return value
Type | Description |
---|---|
Promise<CutoutInfo> | Promise used to return the CutoutInfo object. |
Error codes
For details about the error codes, see Display Error Codes.
ID | Error Message |
---|---|
1400001 | Invalid display or screen. |
Example
import { BusinessError } from '@ohos.base';
let displayClass: display.Display|null = null;
try {
displayClass = display.getDefaultDisplaySync();
let promise: Promise<display.CutoutInfo> = displayClass.getCutoutInfo();
promise.then((data: display.CutoutInfo) => {
console.info('Succeeded in getting cutoutInfo. Data: ' + JSON.stringify(data));
}).catch((err: BusinessError) => {
console.error('Failed to obtain all the display objects. Code: ' + JSON.stringify(err));
});
} catch (exception) {
console.error('Failed to obtain the default display object. Code: ' + JSON.stringify(exception));
}
你可能感兴趣的鸿蒙文章
harmony 鸿蒙System Common Events (To Be Deprecated Soon)
harmony 鸿蒙System Common Events
harmony 鸿蒙API Reference Document Description
harmony 鸿蒙Enterprise Device Management Overview (for System Applications Only)
harmony 鸿蒙BundleStatusCallback
harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager)
harmony 鸿蒙@ohos.distributedBundle (Distributed Bundle Management)
harmony 鸿蒙@ohos.bundle (Bundle)
harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (EnterpriseAdminExtensionAbility)
- 所属分类: 后端技术
- 本文标签:
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦