HarmonyOS鸿蒙学习笔记（17）获取屏幕宽高等属性

@ohos.display屏幕属性提供管理显示设备的一些基础能力，包括获取默认显示设备的信息，获取所有显示设备的信息以及监听显示设备的插拔行为。我们可以通过该组件获取屏幕的宽高等信息

获取屏幕属性的三种方法

在@Component的aboutToAppear方法调用@ohos.display的相关API，可以获取屏幕的属性。@ohos.display提供了三个获取屏幕属性的方法：getDefaultDisplay(callback: AsyncCallback<Display>)、getDefaultDisplay()、getAllDisplay(callback: AsyncCallback<Array<Display>>)方法。下面简单看下三个方法的用法。

getDefaultDisplay(callback: AsyncCallback)的用法

在使用的时候，需要import display from '@ohos.display'引入组件。

//引入@ohos.display组件
import display from '@ohos.display';
@Entry
@Component
struct Index {
    
    
  aboutToAppear() {
    
    
    // 获取屏幕宽高
    display.getDefaultDisplay((err, data) => {
    
    
      if (err) {
    
    
        console.error('Failed to obtain the default display object. Code:  ' + JSON.stringify(err));
        return;
      }
      console.info(JSON.stringify(data));
    });
  }
}

输入为：

{
    
    
    "alive":true,
    "densityDPI":560,
    "densityPixels":3.5,
    "height":2560,
    "id":0,
    "name":"内置屏幕",
    "refreshRate":60.000004,
    "rotation":0,
    "scaledDensity":3.5,
    "state":2,
    "width":1440,
    "xDPI":560,
    "yDPI":560
}

各个字段的含义：

比如我们想要获取宽，则只需要使用data.width即可。

getDefaultDisplay()的用法

获取当前默认的display对象。使用Promise异步回调。该方法返回的是Promise

  let promise = display.getDefaultDisplay();
    promise.then((data) => {
    
    //此处data为Display对象
      console.info(JSON.stringify(data));
    }).catch((err) => {
    
    
      console.info( JSON.stringify(err));
    });

输出同getDefaultDisplay(callback: AsyncCallback<Display>)

getAllDisplay(callback: AsyncCallback<Array>)的用法

获取当前所有的display对象。使用Promise异步回调。返回的是json数组。

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

输出为JSON数组：

[
    {
    
    
        "alive":true,
        "densityDPI":560,
        "densityPixels":3.5,
        "height":2560,
        "id":0,
        "name":"内置屏幕",
        "refreshRate":60.000004,
        "rotation":0,
        "scaledDensity":3.5,
        "state":2,
        "width":1440,
        "xDPI":560,
        "yDPI":560
    }
]

参考资料

@ohos.display官方文档