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