HarmonyOS实战开发：@ohos.display (屏幕属性)

最新推荐文章于 2024-11-09 15:19:25 发布
最新推荐文章于 2024-11-09 15:19:25 发布
阅读量1.3k 收藏 24
点赞数 19
分类专栏： 鸿蒙 文章标签： harmonyos 华为 鸿蒙系统 鸿蒙 android
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_84194030/article/details/139298321
版权

屏幕属性提供管理显示设备的一些基础能力，包括获取默认显示设备的信息，获取所有显示设备的信息以及监听显示设备的插拔行为。

说明：

本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import display from '@ohos.display';

DisplayState

显示设备的状态枚举。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称值说明
STATE_UNKNOWN0表示显示设备状态未知。
STATE_OFF1表示显示设备状态为关闭。
STATE_ON2表示显示设备状态为开启。
STATE_DOZE3表示显示设备为低电耗模式。
STATE_DOZE_SUSPEND4表示显示设备为睡眠模式，CPU为挂起状态。
STATE_VR5表示显示设备为VR模式。
STATE_ON_SUSPEND6表示显示设备为开启状态，CPU为挂起状态。

Orientation10+

显示设备当前显示的方向枚举。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称值说明
PORTRAIT0表示设备当前以竖屏方式显示。
LANDSCAPE1表示设备当前以横屏方式显示。
PORTRAIT_INVERTED2表示设备当前以反向竖屏方式显示。
LANDSCAPE_INVERTED3表示设备当前以反向横屏方式显示。

FoldStatus10+

当前可折叠设备的折叠状态枚举。

系统能力： SystemCapability.Window.SessionManager

名称值说明
FOLD_STATUS_UNKNOWN0表示设备当前折叠状态未知。
FOLD_STATUS_EXPANDED1表示设备当前折叠状态为完全展开。
FOLD_STATUS_FOLDED2表示设备当前折叠状态为折叠。
FOLD_STATUS_HALF_FOLDED3表示设备当前折叠状态为半折叠。半折叠指完全展开和折叠之间的状态。

FoldDisplayMode10+

可折叠设备的显示模式枚举。

系统能力： SystemCapability.Window.SessionManager

名称值说明
FOLD_DISPLAY_MODE_UNKNOWN0表示设备当前折叠显示模式未知。
FOLD_DISPLAY_MODE_FULL1表示设备当前全屏显示。
FOLD_DISPLAY_MODE_MAIN2表示设备当前主屏幕显示。
FOLD_DISPLAY_MODE_SUB3表示设备当前子屏幕显示。
FOLD_DISPLAY_MODE_COORDINATION4表示设备当前双屏协同显示。

FoldCreaseRegion10+

折叠折痕区域。

系统能力： SystemCapability.Window.SessionManager

名称类型可读可写说明
displayId数是否显示器ID，用于识别折痕所在的屏幕。
creaseRectsArray<Rect>是否折痕区域。

Rect9+

矩形区域。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称类型可读可写说明
left数是是矩形区域的左边界，单位为像素，该参数应为整数。
top数是是矩形区域的上边界，单位为像素，该参数应为整数。
宽度数是是矩形区域的宽度，单位为像素，该参数应为整数。
height数是是矩形区域的高度，单位为像素，该参数应为整数。

WaterfallDisplayAreaRects9+

瀑布屏曲面部分显示区域。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称类型可读可写说明
leftRect是否瀑布曲面区域的左侧矩形区域。
topRect是否瀑布曲面区域的顶部矩形区域。
rightRect是否瀑布曲面区域的右侧矩形区域。
底Rect是否瀑布曲面区域的底部矩形区域。

CutoutInfo9+

挖孔屏、刘海屏、瀑布屏等不可用屏幕区域信息。

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称类型可读可写说明
boundingRectsArray<Rect>是否挖孔、刘海等区域的边界矩形。
waterfallDisplayAreaRectsWaterfallDisplayAreaRects是否瀑布屏曲面部分显示区域。

display.getDefaultDisplaySync9+

getDefaultDisplaySync(): Display

获取当前默认的display对象。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型说明
Display返回默认的display对象。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400001Invalid display or screen.

示例：

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

获取当前所有的display对象，使用callback异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
回调AsyncCallback<Array<Display>>是回调函数。返回当前所有的display对象。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400001Invalid display or screen.

示例：

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>>

获取当前所有的display对象，使用Promise异步回调。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型说明
Promise<Array<Display>>Promise对象。返回当前所有的display对象。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400001Invalid display or screen.

示例：

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

查询指定display对象上是否有可见的隐私窗口。可通过setWindowPrivacyMode()接口设置隐私窗口。隐私窗口内容将无法被截屏或录屏。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
同上数是显示设备的id，该参数仅支持整数输入。

返回值：

类型说明
布尔查询的display对象上是否有可见的隐私窗口。
true表示此display对象上有可见的隐私窗口，false表示此display对象上没有可见的隐私窗口。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400003This display manager service works abnormally.

示例：

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

开启显示设备变化的监听。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
类型字符串是监听事件。
- type为"add"，表示增加显示设备事件。例如：插入显示器。
- type为"remove"，表示移除显示设备事件。例如：移除显示器。
- type为"change"，表示改变显示设备事件。例如：显示器方向改变。
回调Callback<number>是回调函数。返回监听到的显示设备的id，该参数应为整数。

示例：

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

关闭显示设备变化的监听。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
类型字符串是监听事件。
- type为"add"，表示增加显示设备事件。例如：插入显示器。
- type为"remove"，表示移除显示设备事件。例如：移除显示器。
- type为"change"，表示改变显示设备事件。例如：显示器方向改变。
回调Callback<number>否回调函数。返回监听到的显示设备的id，该参数应为整数。

示例：

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

开启屏幕隐私模式变化的监听。当屏幕前台有隐私窗口，则屏幕处于隐私模式，屏幕中的隐私窗口内容无法被截屏或录屏。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
类型字符串是监听事件，固定为'privateModeChange'，表示屏幕隐私模式状态发生变化。
回调Callback<boolean>是回调函数。表示屏幕隐私模式是否改变。true表示屏幕由非隐私窗口模式变为隐私模式，false表示屏幕由隐私模式变为非隐私模式。

示例：

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

关闭屏幕隐私模式变化的监听。当屏幕前台有隐私窗口，则屏幕处于隐私模式，屏幕中的隐私窗口内容无法被截屏或录屏。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
类型字符串是监听事件，固定为'privateModeChange'，表示屏幕隐私模式状态发生变化。
回调Callback<boolean>否回调函数。表示屏幕隐私模式是否改变。true表示屏幕由非隐私模式变为隐私模式，false表示屏幕由隐私模式变为非隐私模式。

示例：

try {
  display.off("privateModeChange");
} catch (exception) {
  console.error('Failed to unregister callback. Code: ' + JSON.stringify(exception));
}

display.isFoldable10+

isFoldable(): boolean

检查设备是否可折叠。

系统能力： SystemCapability.Window.SessionManager

返回值：

类型说明
布尔boolean对象，返回当前设备是否可折叠的结果。false表示不可折叠，true表示可折叠。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400003This display manager service works abnormally.

示例：

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

更改可折叠设备的显示模式。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Window.SessionManager

参数：

参数名类型必填说明
模式FoldDisplayMode是可折叠设备的显示模式。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400003This display manager service works abnormally.

示例：

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

获取可折叠设备的当前折叠状态。

系统能力： SystemCapability.Window.SessionManager

返回值：

类型说明
FoldStatusFoldStatus对象，返回当前可折叠设备的折叠状态。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400003This display manager service works abnormally.

示例：

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

获取可折叠设备的显示模式。

系统能力： SystemCapability.Window.SessionManager

返回值：

类型说明
FoldDisplayModeFoldDisplayMode对象，返回当前可折叠设备的显示模式。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400003This display manager service works abnormally.

示例：

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

在当前显示模式下获取折叠折痕区域。

系统能力： SystemCapability.Window.SessionManager

返回值：

类型说明
FoldCreaseRegionFoldCreaseRegion对象，返回设备在当前显示模式下的折叠折痕区域。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400003This display manager service works abnormally.

示例：

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

开启折叠设备折叠状态变化的监听。

系统能力： SystemCapability.Window.SessionManager

参数：

参数名类型必填说明
类型字符串是监听事件，固定为'foldStatusChange'，表示折叠设备折叠状态发生变化。
回调Callback<FoldStatus>是回调函数。表示折叠设备折叠状态。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400003This display manager service works abnormally.

示例：

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

关闭折叠设备折叠状态变化的监听。

系统能力： SystemCapability.Window.SessionManager

参数：

参数名类型必填说明
类型字符串是监听事件，固定为'foldStatusChange'，表示折叠设备折叠状态发生变化。
回调Callback<FoldStatus>否回调函数。表示折叠设备的折叠状态。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400003This display manager service works abnormally.

示例：

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

开启折叠设备屏幕显示模式变化的监听。

系统能力： SystemCapability.Window.SessionManager

参数：

参数名类型必填说明
类型字符串是监听事件，固定为'foldDisplayModeChange'，表示折叠设备屏幕显示模式发生变化。
回调Callback<FoldDisplayMode>是回调函数。表示折叠设备屏幕显示模式。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400003This display manager service works abnormally.

示例：

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

关闭折叠设备屏幕显示模式变化的监听。

系统能力： SystemCapability.Window.SessionManager

参数：

参数名类型必填说明
类型字符串是监听事件，固定为'foldDisplayModeChange'，表示折叠设备屏幕显示模式发生变化。
回调Callback<FoldDisplayMode>否回调函数。表示折叠设备屏幕显示模式。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400003This display manager service works abnormally.

示例：

try {
  display.off('foldDisplayModeChange');
} catch (exception) {
  console.error('Failed to unregister callback. Code: ' + JSON.stringify(exception));
}

display.getDefaultDisplay(deprecated)

getDefaultDisplay(callback: AsyncCallback<Display>): void

获取当前默认的display对象，使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃，推荐使用getDefaultDisplaySync()。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
回调AsyncCallback<Display>是回调函数。返回当前默认的display对象。

示例：

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>

获取当前默认的display对象，使用Promise异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃，推荐使用getDefaultDisplaySync()。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型说明
Promise<Display>Promise对象。返回当前默认的display对象。

示例：

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

获取当前所有的display对象，使用callback异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃，推荐使用getAllDisplays()。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
回调AsyncCallback<Array<Display>>是回调函数。返回当前所有的display对象。

示例：

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>>

获取当前所有的display对象，使用Promise异步回调。

说明：

从 API version 7开始支持，从API version 9开始废弃，推荐使用getAllDisplays()。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型说明
Promise<Array<Display>>Promise对象。返回当前所有的display对象。

示例：

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

屏幕实例。描述display对象的属性和方法。

下列API示例中都需先使用getAllDisplays()、getDefaultDisplaySync()中的任一方法获取到Display实例，再通过此实例调用对应方法。

属性

系统能力： SystemCapability.WindowManager.WindowManager.Core

名称类型可读可写说明
同上数是否显示设备的id号，该参数应为整数。
名字字符串是否显示设备的名称。
alive布尔是否显示设备是否启用。
stateDisplayState是否显示设备的状态。
refreshRate数是否显示设备的刷新率，该参数应为整数。
rotation数是否显示设备的屏幕顺时针旋转角度。
值为0时，表示显示设备屏幕顺时针旋转为0°；
值为1时，表示显示设备屏幕顺时针旋转为90°；
值为2时，表示显示设备屏幕顺时针旋转为180°；
值为3时，表示显示设备屏幕顺时针旋转为270°。
宽度数是否显示设备的宽度，单位为像素，该参数应为整数。
height数是否显示设备的高度，单位为像素，该参数应为整数。
densityDPI数是否显示设备的屏幕密度，表示每英寸点数。该参数为浮点数，一般取值160.0、480.0等。
orientation10+Orientation是否表示屏幕当前显示的方向。
densityPixels数是否显示设备的逻辑密度，是像素单位无关的缩放系数。该参数为浮点数，一般取值1.0、3.0等。
scaledDensity数是否显示设备的显示字体的缩放因子。该参数为浮点数，通常与densityPixels相同。
xDPI数是否x方向中每英寸屏幕的确切物理像素值，该参数为浮点数。
yDPI数是否y方向中每英寸屏幕的确切物理像素值，该参数为浮点数。

getCutoutInfo9+

getCutoutInfo(callback: AsyncCallback<CutoutInfo>): void

获取挖孔屏、刘海屏、瀑布屏等不可用屏幕区域信息。使用callback异步回调。建议应用布局规避该区域。

系统能力： SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
回调AsyncCallback<CutoutInfo>是回调函数。返回描述不可用屏幕区域的CutoutInfo对象。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400001Invalid display or screen.

示例：

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>

获取挖孔屏、刘海屏、瀑布屏等不可用屏幕区域信息。使用Promise异步回调。建议应用布局规避该区域。

系统能力： SystemCapability.WindowManager.WindowManager.Core

返回值：

类型说明
Promise<CutoutInfo>Promise对象。返回描述不可用屏幕区域的CutoutInfo对象。

错误码：

以下错误码的详细介绍请参见屏幕错误码。

错误码ID错误信息
1400001Invalid display or screen.

示例：

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));
}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。

蜀道衫QAQ
关注
专栏目录
鸿蒙Harmony应用开发—ArkTS-高级组件：@ohos.advertising.AdComponent (非全屏广告展示组件)）
m0_64420071的博客
03-19 981
@ohos.advertising.AdComponent (非全屏广告展示组件)）
HarmonyOS源码获取大全
热门推荐
华为开发者联盟
09-11 1万+
源码获取 详情请参考：https://gitee.com/openharmony/docs/blob/master/get-code/%E6%BA%90%E7%A0%81%E8%8E%B7%E5%8F%96.md OpenHarmony介绍   OpenHarmony是HarmonyOS的开源版，由华为捐赠给开放原子开源基金会（OpenAtom Foundation）开源。第一个开源版本支持在128KB~128MB设备上运行，欢迎参加开源社区一起持续演进。   代码仓库地址：https://openharm
鸿蒙-怎么监听折叠屏的开合
m0_51170428的博客
08-12 544
这个foldstatus上报后还有要完成对应的切屏操作,更新屏幕属性后才会通知监听folddisplaymode变化。foldstatus即折叠态是hall器件和posture器件上报后我们得到对应折叠状态就通知监听变化。console.log('屏幕宽度：' + w + ', status: ' + data);console.log('屏幕宽度：' + w + ', status: ' + data);因此，建议使用displaymode,不要用foldstatus；
HarmonyOS NEXT实战开发：@ohos.display (屏幕属性)
hanyanyou的博客
07-22 702
屏幕属性提供管理显示设备的一些基础能力，包括获取默认显示设备的信息，获取所有显示设备的信息以及监听显示设备的插拔行为。
鸿蒙NEXT开发【折叠屏设计实践】场景设备
ADgai1987的博客
09-18 1040
折叠屏形态展开态：折叠屏设备完全展开后的形态。有更大的屏幕尺寸，可充分显示应用内容。 折叠态：折叠屏设备折叠后的形态。折叠后屏幕尺寸变小。 悬停态：折叠屏设备处于完全展开和折叠的中间状态，可平稳放置。
鸿蒙开发接口图形图像：【@ohos.display (屏幕属性)】
2301_76813281的博客
05-28 694
屏幕属性提供管理显示设备的一些基础能力，包括获取默认显示设备的信息，获取所有显示设备的信息以及监听显示设备的插拔行为。
HarmonyOS/OpenHarmony应用开发-ArkTSAPI系统能力SystemCapability列表
weixin_69135651的博客
08-11 2127
SysCap，全称SystemCapability，即系统能力，指操作系统中每一个相对独立的特性。 开发者使用某个接口进行开发前，建议先阅读系统能力使用说明，了解Syscap的定义和使用指导。
鸿蒙开发接口图形图像：【@ohos.window (窗口)】
2301_76813281的博客
05-29 990
窗口提供管理窗口的一些基础能力，包括对当前窗口的创建、销毁、各属性设置，以及对各窗口间的管理调度。
HarmonyOS鸿蒙学习笔记（17）获取屏幕宽高等属性
菜鸟博客
01-11 5522
鸿蒙获取屏幕的宽和高
HarmonyOS实战—影视类卡片应用
李元静
06-20 7323
目录HarmonyOS实战影视类卡片应用实战swiper选项卡推荐功能网络数据请求页面路由list列表横向视频推荐grid网格视频推荐样式文件（index.css）视频播放页面页面（pagevideo.hml）用户交互（pagevideo.js）界面样式（pagevideo.css）其他设置 HarmonyOS实战 影视类卡片应用实战 在前面，博主详细介绍了HarmonyOS原子化服务的优点，通过卡片式操作，我们可以快速找到我们想要的功能模块。 而在实际的用户体验中，比如影视类用户，有这么一群人，它们只关
HarmonyOS实战开发-如何实现一个简单的健康生活应用（上）
2401_82546228的博客
03-31 1262
用户点击悬浮按钮进入任务列表页，点击任务列表可进入对应任务编辑的页面中，对任务进行详细的设置，之后点击完成按钮编辑任务后将返回首页。在组件CustomDialogView的aboutToAppear生命周期中注册SHOW_TASK_DETAIL_DIALOG的事件回调方法 ，当通过emit触发此事件时即触发回调方法执行。@Component// 成就对话框});// 任务时钟对话框});// 成就对话框});// 任务时钟对话框});build() {
OpenHarmony实战开发-如何实现组件动画。
2401_82546228的博客
04-28 877
ArkUI为组件提供了通用的属性动画和转场动画能力的同时，还为一些组件提供了默认的动画效果。例如，List的滑动动效，Button的点击动效，是组件自带的默认动画效果。在组件默认动画效果的基础上，开发者还可以通过属性动画和转场动画对容器组件内的子组件动效进行定制。
OpenHarmony实战开发-如何使用屏幕属性getDefaultDisplaySync、getCutoutInfo接口实现适配挖孔屏。
m0_70749039的博客
04-17 535
本示例介绍使用屏幕属性getDefaultDisplaySync、getCutoutInfo接口实现适配挖孔屏。该场景多用于沉浸式场景下。
HarmonyOS NEXT 折叠屏扫描二维码方案
shudaoshanQAQ的博客
04-02 826
本示例介绍使用自定义界面扫码能力在折叠屏设备中实现折叠态切换适配。
鸿蒙OS开发学习：【尺寸适配实现】
m0_62167422的博客
04-10 1841
在鸿蒙开发中，尺寸适配是一个重要的概念，它可以帮助我们在不同屏幕尺寸的设备上正确显示和布局我们的应用程序。本文将介绍如何在鸿蒙开发中实现尺寸适配的方法。在鸿蒙开发中，我们可以通过定义适配方案来指定不同屏幕尺寸下的适配策略。这些适配方案通常包括不同屏幕尺寸下的像素密度、字体大小、布局占比等信息。
鸿蒙NEXT实战开发：【截屏】
鸿蒙的技术博客
03-07 806
展示全屏截图和屏幕局部截图。通过[screenshot]模块实现屏幕截图 ，通过[window]模块实现隐私窗口切换，通过[display]模块查询当前隐私窗口。
Native API 在 HarmonyOS 应用工程中的使用指导
HarmonyOSDev的博客
12-05 1827
本示例通过实现 storage 模块展示了同步和异步方法的封装。storage 模块实现了数据的保存、获取、删除、清除功能。本示例展示了 on/off/once 订阅方法的实现，同时也包含了 C++ 与 js 对象通过 wrap 接口的绑定。NetServer 模块实现了一个网络服务。本示例介绍如何在非 JS 线程中回调 JS 应用的回调函数。
鸿蒙进阶篇-剩余和展开、简单和复杂类型
最新发布
2401_88463044的博客
11-09 1445
以下是关于“剩余和展开”“简单和复杂类型”概念的文章摘要： “剩余”参数使函数能够接收不定数量的额外参数，并以数组形式处理，增加了函数参数的灵活性。“展开”常见于数组或对象操作，如将数组元素或对象属性展开用于特定场景。 “简单类型”为基本的数据类型，如整数、浮点数等，具有固定大小和简单操作。“复杂类型”如数组、对象、类等，由多种简单或复杂类型组合而成，结构丰富，操作较复杂。 这些概念在编程中各自发挥重要作用，影响着数据处理和程序结构的设计。
以下声明，可以隐藏对象的是? A.display:block B.display:inline C.display:none D.display:inline-block
05-30
可以隐藏对象的声明是 C. display: none。该声明可以将元素完全隐藏，不占据空间，也不会对页面布局造成影响。而 display: block、display: inline、display: inline-block 这三个声明都不能完全隐藏元素，它们只是控制元素的显示方式和盒子模型属性，元素仍然会占据空间。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值