1# NativeDisplayManager_DisplayInfo 2 3 4## 概述 5 6显示设备的对象属性。 7 8**起始版本：** 14 9 10**相关模块：**[OH_DisplayManager](_o_h___display_manager.md) 11 12 13## 汇总 14 15 16### 成员变量 17 18| 名称 | 描述 | 19| -------- | -------- | 20| uint32_t [id](#id) | 显示设备的屏幕id号，为非负整数。 | 21| char [name](#name) [OH_DISPLAY_NAME_LENGTH+1] | 显示设备的名称。 | 22| bool [isAlive](#isalive) | 显示设备是否启用：true表示设备启动，false表示设备未启用。 | 23| int32_t [width](#width) | 显示设备的屏幕宽度，单位为px，该参数应为非负整数。 | 24| int32_t [height](#height) | 显示设备的屏幕高度，单位为px，该参数应为非负整数。 | 25| int32_t [physicalWidth](#physicalwidth) | 显示设备的物理宽度，单位为px，该参数应为非负整数。 | 26| int32_t [physicalHeight](#physicalheight) | 显示设备的物理高度，单位为px，该参数应为非负整数。 | 27| uint32_t [refreshRate](#refreshrate) | 显示设备的刷新率，单位为Hz，该参数应为非负整数，。 | 28| uint32_t [availableWidth](#availablewidth) | 2in1设备上屏幕的可用区域宽度，单位为px，该参数为非负整数。 | 29| uint32_t [availableHeight](#availableheight) | 2in1设备上屏幕的可用区域高度，单位为px，该参数为非负整数。 | 30| float [densityDPI](#densitydpi) | 显示设备屏幕的物理像素密度，表示每英寸上的像素点数。该参数为大于0的浮点数，单位为px。一般取值160.0、480.0等，实际能取到的值取决于不同设备设置里提供的可选值。 | 31| float [densityPixels](#densitypixels) | 显示设备逻辑像素的密度，代表物理像素与逻辑像素的缩放系数。该参数为大于0的浮点数，受densityDPI范围限制，取值范围在[0.5，4.0]。一般取值1.0、3.0等，实际取值取决于不同设备提供的densityDPI。 | 32| float [scaledDensity](#scaleddensity) | 显示设备的显示字体的缩放因子。该参数为大于0的浮点数，通常与densityPixels相同。 | 33| float [xDPI](#xdpi) | 显示设备x方向中每英寸屏幕的确切物理像素值，该参数为大于0的浮点数。 | 34| float [yDPI](#ydpi) | 显示设备y方向中每英寸屏幕的确切物理像素值，该参数为大于0的浮点数。 | 35| [NativeDisplayManager_Rotation](_o_h___display_manager.md#nativedisplaymanager_rotation)[rotation](#rotation) | 显示设备的屏幕顺时针旋转角度。 | 36| [NativeDisplayManager_DisplayState](_o_h___display_manager.md#nativedisplaymanager_displaystate)[state](#state) | 显示设备的状态。 | 37| [NativeDisplayManager_Orientation](_o_h___display_manager.md#nativedisplaymanager_orientation)[orientation](#orientation) | 表示屏幕当前显示的方向。 | 38| [NativeDisplayManager_DisplayHdrFormat](_native_display_manager___display_hdr_format.md) \* [hdrFormat](#hdrformat) | 显示设备支持的所有HDR格式。 | 39| [NativeDisplayManager_DisplayColorSpace](_native_display_manager___display_color_space.md) \* [colorSpace](#colorspace) | 显示设备支持的所有色域类型。 | 40 41 42## 结构体成员变量说明 43 44 45### availableHeight 46 47``` 48uint32_t NativeDisplayManager_DisplayInfo::availableHeight 49``` 50 51**描述** 52 532in1设备上屏幕的可用区域高度，单位为px，该参数为非负整数。 54 55 56### availableWidth 57 58``` 59uint32_t NativeDisplayManager_DisplayInfo::availableWidth 60``` 61 62**描述** 63 642in1设备上屏幕的可用区域宽度，单位为px，该参数为非负整数。 65 66 67### colorSpace 68 69``` 70NativeDisplayManager_DisplayColorSpace* NativeDisplayManager_DisplayInfo::colorSpace 71``` 72 73**描述** 74 75显示设备支持的所有色域类型。 76 77 78### densityDPI 79 80``` 81float NativeDisplayManager_DisplayInfo::densityDPI 82``` 83 84**描述** 85 86显示设备屏幕的物理像素密度，表示每英寸上的像素点数。该参数为大于0的浮点数，单位为px。一般取值160.0、480.0等，实际能取到的值取决于不同设备设置里提供的可选值。 87 88 89### densityPixels 90 91``` 92float NativeDisplayManager_DisplayInfo::densityPixels 93``` 94 95**描述** 96 97显示设备逻辑像素的密度，代表物理像素与逻辑像素的缩放系数。该参数为大于0的浮点数，受densityDPI范围限制，取值范围在[0.5，4.0]。一般取值1.0、3.0等，实际取值取决于不同设备提供的densityDPI。 98 99 100### hdrFormat 101 102``` 103NativeDisplayManager_DisplayHdrFormat* NativeDisplayManager_DisplayInfo::hdrFormat 104``` 105 106**描述** 107 108显示设备支持的所有HDR格式。 109 110 111### height 112 113``` 114int32_t NativeDisplayManager_DisplayInfo::height 115``` 116 117**描述** 118 119显示设备的屏幕高度，单位为px，该参数应为非负整数。 120 121 122### id 123 124``` 125uint32_t NativeDisplayManager_DisplayInfo::id 126``` 127 128**描述** 129 130显示设备的屏幕id号，为非负整数。 131 132 133### isAlive 134 135``` 136bool NativeDisplayManager_DisplayInfo::isAlive 137``` 138 139**描述** 140 141显示设备是否启用：true表示设备启动，false表示设备未启用。 142 143 144### name 145 146``` 147char NativeDisplayManager_DisplayInfo::name[OH_DISPLAY_NAME_LENGTH+1] 148``` 149 150**描述** 151 152显示设备的名称。 153 154 155### orientation 156 157``` 158NativeDisplayManager_Orientation NativeDisplayManager_DisplayInfo::orientation 159``` 160 161**描述** 162 163表示屏幕当前显示的方向。 164 165 166### physicalHeight 167 168``` 169int32_t NativeDisplayManager_DisplayInfo::physicalHeight 170``` 171 172**描述** 173 174显示设备的物理高度，单位为px，该参数应为非负整数。 175 176 177### physicalWidth 178 179``` 180int32_t NativeDisplayManager_DisplayInfo::physicalWidth 181``` 182 183**描述** 184 185显示设备的物理宽度，单位为px，该参数应为非负整数。 186 187 188### refreshRate 189 190``` 191uint32_t NativeDisplayManager_DisplayInfo::refreshRate 192``` 193 194**描述** 195 196显示设备的刷新率，单位为Hz，该参数应为非负整数，。 197 198 199### rotation 200 201``` 202NativeDisplayManager_Rotation NativeDisplayManager_DisplayInfo::rotation 203``` 204 205**描述** 206 207显示设备的屏幕顺时针旋转角度。 208 209 210### scaledDensity 211 212``` 213float NativeDisplayManager_DisplayInfo::scaledDensity 214``` 215 216**描述** 217 218显示设备的显示字体的缩放因子。该参数为大于0的浮点数，通常与densityPixels相同。 219 220 221### state 222 223``` 224NativeDisplayManager_DisplayState NativeDisplayManager_DisplayInfo::state 225``` 226 227**描述** 228 229显示设备的状态。 230 231 232### width 233 234``` 235int32_t NativeDisplayManager_DisplayInfo::width 236``` 237 238**描述** 239 240显示设备的屏幕宽度，单位为px，该参数应为非负整数。 241 242 243### xDPI 244 245``` 246float NativeDisplayManager_DisplayInfo::xDPI 247``` 248 249**描述** 250 251显示设备x方向中每英寸屏幕的确切物理像素值，该参数为大于0的浮点数。 252 253 254### yDPI 255 256``` 257float NativeDisplayManager_DisplayInfo::yDPI 258``` 259 260**描述** 261 262显示设备y方向中每英寸屏幕的确切物理像素值，该参数为大于0的浮点数。 263