xref: /docs/en/application-dev/reference/apis-arkui/_o_h___display_manager.md

# OH_DisplayManager


## Overview

The OH_DisplayManager module provides the display management capability.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12


## Summary


### Files

| Name| Description| 
| -------- | -------- |
| [oh_display_info.h](oh__display__info_8h.md) | Declares the common enums and definitions of the display manager.| 
| [oh_display_manager.h](oh__display__manager_8h.md) | Declares the functions for basic display management. You can call the functions to obtain various information about the default display and listen for display status changes, such as rotation, folding, and unfolding.| 


### Structs

| Name| Description| 
| -------- | -------- |
| struct  [NativeDisplayManager_Rect](_native_display_manager___rect.md) | Describes a rectangle.| 
| struct  [NativeDisplayManager_WaterfallDisplayAreaRects](ive_display_manager___waterfall_display_area_rects.md) | Describes the curved area on the waterfall display.| 
| struct  [NativeDisplayManager_CutoutInfo](_native_display_manager___cutout_info.md) | Describes the cutout, which is an area that is not intended for displaying content on the display.| 


### Types

| Name| Description| 
| -------- | -------- |
| typedef enum [NativeDisplayManager_Rotation](#nativedisplaymanager_rotation) [NativeDisplayManager_Rotation](#nativedisplaymanager_rotation) | Defines an enum for the clockwise rotation angles of a display.| 
| typedef enum [NativeDisplayManager_Orientation](#nativedisplaymanager_orientation) [NativeDisplayManager_Orientation](#nativedisplaymanager_orientation) | Defines an enum for the orientations of a display.| 
| typedef enum [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) | Defines an enum for the status codes returned by the display manager interface.| 
| typedef enum [NativeDisplayManager_FoldDisplayMode](#nativedisplaymanager_folddisplaymode) [NativeDisplayManager_FoldDisplayMode](#nativedisplaymanager_folddisplaymode) | Defines an enum for the display modes of a foldable device.| 
| typedef struct [NativeDisplayManager_Rect](_native_display_manager___rect.md) [NativeDisplayManager_Rect](#nativedisplaymanager_rect) | Defines a struct for a rectangle.| 
| typedef struct [NativeDisplayManager_WaterfallDisplayAreaRects](ive_display_manager___waterfall_display_area_rects.md) [NativeDisplayManager_WaterfallDisplayAreaRects](#nativedisplaymanager_waterfalldisplayarearects) | Defines a struct for the curved area on the waterfall display.| 
| typedef struct [NativeDisplayManager_CutoutInfo](_native_display_manager___cutout_info.md) [NativeDisplayManager_CutoutInfo](#nativedisplaymanager_cutoutinfo) | Defines a struct for the cutout, which is an area that is not intended for displaying content on the display.| 
| typedef void(\* [OH_NativeDisplayManager_DisplayChangeCallback](#oh_nativedisplaymanager_displaychangecallback)) (uint64_t displayId) | Defines a callback function used to listen for status changes of a display.| 
| typedef void(\* [OH_NativeDisplayManager_FoldDisplayModeChangeCallback](#oh_nativedisplaymanager_folddisplaymodechangecallback)) ([NativeDisplayManager_FoldDisplayMode](#nativedisplaymanager_folddisplaymode) displayMode) | Defines a callback function used to listen for folded/unfolded state changes of a display.| 


### Enums

| Name| Description| 
| -------- | -------- |
| [NativeDisplayManager_Rotation](#nativedisplaymanager_rotation-1) { DISPLAY_MANAGER_ROTATION_0 = 0, DISPLAY_MANAGER_ROTATION_90 = 1, DISPLAY_MANAGER_ROTATION_180 = 2, DISPLAY_MANAGER_ROTATION_270 = 3 } | Enumerates the clockwise rotation angles of a display.| 
| [NativeDisplayManager_Orientation](#nativedisplaymanager_orientation-1) {<br>DISPLAY_MANAGER_PORTRAIT = 0, DISPLAY_MANAGER_LANDSCAPE = 1, DISPLAY_MANAGER_PORTRAIT_INVERTED = 2, DISPLAY_MANAGER_LANDSCAPE_INVERTED = 3,<br>DISPLAY_MANAGER_UNKNOWN<br>} | Enumerates the orientations of a display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode-1) {<br>DISPLAY_MANAGER_OK = 0, DISPLAY_MANAGER_ERROR_NO_PERMISSION = 201, DISPLAY_MANAGER_ERROR_NOT_SYSTEM_APP = 202, DISPLAY_MANAGER_ERROR_INVALID_PARAM = 401,<br>DISPLAY_MANAGER_ERROR_DEVICE_NOT_SUPPORTED = 801, DISPLAY_MANAGER_ERROR_INVALID_SCREEN = 1400001, DISPLAY_MANAGER_ERROR_INVALID_CALL = 1400002, DISPLAY_MANAGER_ERROR_SYSTEM_ABNORMAL = 1400003<br>} | Enumerates the status codes returned by the display manager interface.| 
| [NativeDisplayManager_FoldDisplayMode](#nativedisplaymanager_folddisplaymode-1) {<br>DISPLAY_MANAGER_FOLD_DISPLAY_MODE_UNKNOWN = 0, DISPLAY_MANAGER_FOLD_DISPLAY_MODE_FULL = 1, DISPLAY_MANAGER_FOLD_DISPLAY_MODE_MAIN = 2, DISPLAY_MANAGER_FOLD_DISPLAY_MODE_SUB = 3,<br>DISPLAY_MANAGER_FOLD_DISPLAY_MODE_COORDINATION = 4<br>} | Enumerates the display modes of a foldable device.| 


### Functions

| Name| Description| 
| -------- | -------- |
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetDefaultDisplayId](#oh_nativedisplaymanager_getdefaultdisplayid) (uint64_t \*displayId) | Obtains the ID of the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetDefaultDisplayWidth](#oh_nativedisplaymanager_getdefaultdisplaywidth) (int32_t \*displayWidth) | Obtains the width of the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetDefaultDisplayHeight](#oh_nativedisplaymanager_getdefaultdisplayheight) (int32_t \*displayHeight) | Obtains the height of the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetDefaultDisplayRotation](#oh_nativedisplaymanager_getdefaultdisplayrotation) ([NativeDisplayManager_Rotation](#nativedisplaymanager_rotation) \*displayRotation) | Obtains the clockwise rotation angle of the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetDefaultDisplayOrientation](#oh_nativedisplaymanager_getdefaultdisplayorientation) ([NativeDisplayManager_Orientation](#nativedisplaymanager_orientation) \*displayOrientation) | Obtains the orientation of the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetDefaultDisplayVirtualPixelRatio](#oh_nativedisplaymanager_getdefaultdisplayvirtualpixelratio) (float \*virtualPixels) | Obtains the virtual pixel ratio of the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetDefaultDisplayRefreshRate](#oh_nativedisplaymanager_getdefaultdisplayrefreshrate) (uint32_t \*refreshRate) | Obtains the refresh rate of the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetDefaultDisplayDensityDpi](#oh_nativedisplaymanager_getdefaultdisplaydensitydpi) (int32_t \*densityDpi) | Obtains the physical pixel density of the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetDefaultDisplayDensityPixels](#oh_nativedisplaymanager_getdefaultdisplaydensitypixels) (float \*densityPixels) | Obtains the logical pixel density of the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetDefaultDisplayScaledDensity](#oh_nativedisplaymanager_getdefaultdisplayscaleddensity) (float \*scaledDensity) | Obtains the scale factor of the font displayed on the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetDefaultDisplayDensityXdpi](#oh_nativedisplaymanager_getdefaultdisplaydensityxdpi) (float \*xDpi) | Obtains the number of physical pixels that are displayed horizontally per inch on the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetDefaultDisplayDensityYdpi](#oh_nativedisplaymanager_getdefaultdisplaydensityydpi) (float \*yDpi) | Obtains the number of physical pixels that are displayed vertically per inch on the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_CreateDefaultDisplayCutoutInfo](#oh_nativedisplaymanager_createdefaultdisplaycutoutinfo) ([NativeDisplayManager_CutoutInfo](_native_display_manager___cutout_info.md) \*\*cutoutInfo) | Obtains the cutout information of the default display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_DestroyDefaultDisplayCutoutInfo](#oh_nativedisplaymanager_destroydefaultdisplaycutoutinfo) ([NativeDisplayManager_CutoutInfo](_native_display_manager___cutout_info.md) \*cutoutInfo) | Destroys the cutout information of the default display.| 
| bool [OH_NativeDisplayManager_IsFoldable](#oh_nativedisplaymanager_isfoldable) () | Checks whether the device is foldable.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_GetFoldDisplayMode](#oh_nativedisplaymanager_getfolddisplaymode) ([NativeDisplayManager_FoldDisplayMode](#nativedisplaymanager_folddisplaymode) \*displayMode) | Obtains the display mode of the foldable device.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_RegisterDisplayChangeListener](#oh_nativedisplaymanager_registerdisplaychangelistener) ([OH_NativeDisplayManager_DisplayChangeCallback](#oh_nativedisplaymanager_displaychangecallback) displayChangeCallback, uint32_t \*listenerIndex) | Registers a listener for status changes (such as rotation, refresh rate, DPI, and resolution changes) of the display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_UnregisterDisplayChangeListener](#oh_nativedisplaymanager_unregisterdisplaychangelistener) (uint32_t listenerIndex) | Cancels the listening for status changes of the display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_RegisterFoldDisplayModeChangeListener](#oh_nativedisplaymanager_registerfolddisplaymodechangelistener) ([OH_NativeDisplayManager_FoldDisplayModeChangeCallback](#oh_nativedisplaymanager_folddisplaymodechangecallback) displayModeChangeCallback, uint32_t \*listenerIndex) | Registers a listener for folded/unfolded state changes of the display.| 
| [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode) [OH_NativeDisplayManager_UnregisterFoldDisplayModeChangeListener](#oh_nativedisplaymanager_unregisterfolddisplaymodechangelistener) (uint32_t listenerIndex) | Cancels the listening for folded/unfolded state changes of the display.| 


## Type Description


### NativeDisplayManager_CutoutInfo

```
typedef struct NativeDisplayManager_CutoutInfo NativeDisplayManager_CutoutInfo
```

**Description**

Defines a struct for the cutout, which is an area that is not intended for displaying content on the display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12


### NativeDisplayManager_ErrorCode

```
typedef enum NativeDisplayManager_ErrorCode NativeDisplayManager_ErrorCode
```

**Description**

Defines an enum for the status codes returned by the display manager interface.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12


### NativeDisplayManager_FoldDisplayMode

```
typedef enum NativeDisplayManager_FoldDisplayMode NativeDisplayManager_FoldDisplayMode
```

**Description**

Defines an enum for the display modes of a foldable device.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12


### NativeDisplayManager_Orientation

```
typedef enum NativeDisplayManager_Orientation NativeDisplayManager_Orientation
```

**Description**

Defines an enum for the orientations of a display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12


### NativeDisplayManager_Rect

```
typedef struct NativeDisplayManager_Rect NativeDisplayManager_Rect
```

**Description**

Defines a struct for a rectangle.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12


### NativeDisplayManager_Rotation

```
typedef enum NativeDisplayManager_Rotation NativeDisplayManager_Rotation
```

**Description**

Defines an enum for the clockwise rotation angles of a display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12


### NativeDisplayManager_WaterfallDisplayAreaRects

```
typedef struct NativeDisplayManager_WaterfallDisplayAreaRects NativeDisplayManager_WaterfallDisplayAreaRects
```

**Description**

Defines a struct for the curved area on the waterfall display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12


### OH_NativeDisplayManager_DisplayChangeCallback

```
typedef void(* OH_NativeDisplayManager_DisplayChangeCallback) (uint64_t displayId)
```

**Description**

Defines a callback function used to listen for status changes of a display.

**System capability**: SystemCapability.Window.SessionManager

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| displayId | ID of the display.| 


### OH_NativeDisplayManager_FoldDisplayModeChangeCallback

```
typedef void(* OH_NativeDisplayManager_FoldDisplayModeChangeCallback) (NativeDisplayManager_FoldDisplayMode displayMode)
```

**Description**

Defines a callback function used to listen for folded/unfolded state changes of a display.

**System capability**: SystemCapability.Window.SessionManager

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| displayMode | Folded or unfolded state of the display. For details about the available options, see [NativeDisplayManager_FoldDisplayMode](#nativedisplaymanager_folddisplaymode).| 


## Enum Description


### NativeDisplayManager_ErrorCode

```
enum NativeDisplayManager_ErrorCode
```

**Description**

Enumerates the status codes returned by the display manager interface.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

| Value| Description| 
| -------- | -------- |
| DISPLAY_MANAGER_OK | The operation is successful.| 
| DISPLAY_MANAGER_ERROR_NO_PERMISSION | Permission verification failed. The application does not have the permission to use the API.| 
| DISPLAY_MANAGER_ERROR_NOT_SYSTEM_APP | Permission verification failed. A non-system application attempts to call a system API.| 
| DISPLAY_MANAGER_ERROR_INVALID_PARAM | Parameter check fails.| 
| DISPLAY_MANAGER_ERROR_DEVICE_NOT_SUPPORTED | The device does not support the API.| 
| DISPLAY_MANAGER_ERROR_INVALID_SCREEN | The display is invalid.| 
| DISPLAY_MANAGER_ERROR_INVALID_CALL | The current operation object does not have the operation permission.| 
| DISPLAY_MANAGER_ERROR_SYSTEM_ABNORMAL | The system service is abnormal.| 


### NativeDisplayManager_FoldDisplayMode

```
enum NativeDisplayManager_FoldDisplayMode
```

**Description**

Enumerates the display modes of a foldable device.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

| Value| Description| 
| -------- | -------- |
| DISPLAY_MANAGER_FOLD_DISPLAY_MODE_UNKNOWN | The display mode of the device is unknown.| 
| DISPLAY_MANAGER_FOLD_DISPLAY_MODE_FULL | The device is displayed in full screen.| 
| DISPLAY_MANAGER_FOLD_DISPLAY_MODE_MAIN | The main screen of the device is displayed.| 
| DISPLAY_MANAGER_FOLD_DISPLAY_MODE_SUB | The subscreen of the device is displayed.| 
| DISPLAY_MANAGER_FOLD_DISPLAY_MODE_COORDINATION | Both screens of the device are displayed in collaborative mode.| 


### NativeDisplayManager_Orientation

```
enum NativeDisplayManager_Orientation
```

**Description**

Enumerates the orientations of a display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

| Value| Description| 
| -------- | -------- |
| DISPLAY_MANAGER_PORTRAIT | The display is in portrait mode.| 
| DISPLAY_MANAGER_LANDSCAPE | The display is in landscape mode.| 
| DISPLAY_MANAGER_PORTRAIT_INVERTED | The display is in reverse portrait mode.| 
| DISPLAY_MANAGER_LANDSCAPE_INVERTED | The display is in reverse landscape mode.| 
| DISPLAY_MANAGER_UNKNOWN | The screen orientation is unknown.| 


### NativeDisplayManager_Rotation

```
enum NativeDisplayManager_Rotation
```

**Description**

Enumerates the clockwise rotation angles of a display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

| Value| Description| 
| -------- | -------- |
| DISPLAY_MANAGER_ROTATION_0 | The display is rotated clockwise by 0 degrees.| 
| DISPLAY_MANAGER_ROTATION_90 | The display is rotated clockwise by 90 degrees.| 
| DISPLAY_MANAGER_ROTATION_180 | The display is rotated clockwise by 180 degrees.| 
| DISPLAY_MANAGER_ROTATION_270 | The display is rotated clockwise by 270 degrees.| 


## Function Description


### OH_NativeDisplayManager_CreateDefaultDisplayCutoutInfo()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_CreateDefaultDisplayCutoutInfo (NativeDisplayManager_CutoutInfo **cutoutInfo)
```

**Description**

Obtains the cutout information of the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| cutoutInfo | Double pointer to the cutout information. For details, see [NativeDisplayManager_CutoutInfo](_native_display_manager___cutout_info.md).| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_DestroyDefaultDisplayCutoutInfo()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_DestroyDefaultDisplayCutoutInfo (NativeDisplayManager_CutoutInfo *cutoutInfo)
```

**Description**

Destroys the cutout information of the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| cutoutInfo | Pointer to the cutout information object obtained by calling [OH_NativeDisplayManager_CreateDefaultDisplayCutoutInfo](#oh_nativedisplaymanager_createdefaultdisplaycutoutinfo). For details, see [NativeDisplayManager_CutoutInfo](_native_display_manager___cutout_info.md).| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetDefaultDisplayDensityDpi()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayDensityDpi (int32_t *densityDpi)
```

**Description**

Obtains the physical pixel density of the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| densityDpi | Pointer to the physical pixel density, that is, the number of pixels per inch. The value is a floating point number, in px. The actual value depends on the options provided in device settings.  | 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetDefaultDisplayDensityPixels()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayDensityPixels (float *densityPixels)
```

**Description**

Obtains the logical pixel density of the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| densityPixels | Pointer to the logical pixel density, which indicates the scaling coefficient of the physical pixels and logical pixels. The value is a floating point number in the range [0.5, 4.0]. Generally, the value is **1.0** or **3.0**. The actual value depends on the density DPI provided by the device in use.  | 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetDefaultDisplayDensityXdpi()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayDensityXdpi (float *xDpi)
```

**Description**

Obtains the number of physical pixels that are displayed horizontally per inch on the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| xDpi | Pointer to the number of physical pixels displayed horizontally per inch. The value is a floating point number.| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetDefaultDisplayDensityYdpi()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayDensityYdpi (float *yDpi)
```

**Description**

Obtains the number of physical pixels that are displayed vertically per inch on the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| yDpi | Pointer to the number of physical pixels displayed vertically per inch. The value is a floating point number.| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetDefaultDisplayHeight()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayHeight (int32_t *displayHeight)
```

**Description**

Obtains the height of the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| displayHeight | Pointer to the height, in px. The value is an integer.| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetDefaultDisplayId()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayId (uint64_t *displayId)
```

**Description**

Obtains the ID of the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| displayId | Pointer to the display ID. The value is a non-negative integer.| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetDefaultDisplayOrientation()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayOrientation (NativeDisplayManager_Orientation *displayOrientation)
```

**Description**

Obtains the orientation of the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| displayOrientation | Pointer to the orientation. For details about the available options, see [NativeDisplayManager_Orientation](#nativedisplaymanager_orientation).| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetDefaultDisplayRefreshRate()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayRefreshRate (uint32_t *refreshRate)
```

**Description**

Obtains the refresh rate of the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| refreshRate | Pointer to the refresh rate. The value is an integer, in Hz.| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetDefaultDisplayRotation()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayRotation (NativeDisplayManager_Rotation *displayRotation)
```

**Description**

Obtains the clockwise rotation angle of the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| displayRotation | Pointer to the clockwise rotation angle. For details about the available options, see [NativeDisplayManager_Rotation](#nativedisplaymanager_rotation).| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetDefaultDisplayScaledDensity()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayScaledDensity (float *scaledDensity)
```

**Description**

Obtains the scale factor of the font displayed on the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| scaledDensity | Pointer to the scale factor. The value is a floating-point number, and it is usually the same as that of **densityPixels**.| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetDefaultDisplayVirtualPixelRatio()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayVirtualPixelRatio (float *virtualPixels)
```

**Description**

Obtains the virtual pixel ratio of the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| virtualPixels | Pointer to the virtual pixel ratio. The value is a floating-point number, and it is usually the same as that of **densityPixels**.| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetDefaultDisplayWidth()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetDefaultDisplayWidth (int32_t *displayWidth)
```

**Description**

Obtains the width of the default display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| displayWidth | Pointer to the width, in px. The value is an integer.| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_GetFoldDisplayMode()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_GetFoldDisplayMode (NativeDisplayManager_FoldDisplayMode *displayMode)
```

**Description**

Obtains the display mode of the foldable device.

**System capability**: SystemCapability.Window.SessionManager

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| displayMode | Pointer to the display mode. For details about the available options, see [NativeDisplayManager_FoldDisplayMode](#nativedisplaymanager_folddisplaymode).| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_IsFoldable()

```
bool OH_NativeDisplayManager_IsFoldable ()
```

**Description**

Checks whether the device is foldable.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Returns**

Returns the check result. The value **true** means that the device is foldable, and **false** means the opposite.


### OH_NativeDisplayManager_RegisterDisplayChangeListener()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_RegisterDisplayChangeListener (OH_NativeDisplayManager_DisplayChangeCallback displayChangeCallback, uint32_t *listenerIndex )
```

**Description**

Registers a listener for status changes (such as rotation, refresh rate, DPI, and resolution changes) of the display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| displayChangeCallback | Callback function triggered when the display status is changed. For details, see [OH_NativeDisplayManager_DisplayChangeCallback](#oh_nativedisplaymanager_displaychangecallback).| 
| listenerIndex | Pointer to the index of the listener registered. It is used as an input parameter of [OH_NativeDisplayManager_UnregisterDisplayChangeListener](#oh_nativedisplaymanager_unregisterdisplaychangelistener).| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_RegisterFoldDisplayModeChangeListener()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_RegisterFoldDisplayModeChangeListener (OH_NativeDisplayManager_FoldDisplayModeChangeCallback displayModeChangeCallback, uint32_t *listenerIndex )
```

**Description**

Registers a listener for folded/unfolded state changes of the display.

**System capability**: SystemCapability.Window.SessionManager

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| displayModeChangeCallback | Callback function triggered when the folded/unfolded state of the display is changed. For details, see [OH_NativeDisplayManager_FoldDisplayModeChangeCallback](#oh_nativedisplaymanager_folddisplaymodechangecallback).| 
| listenerIndex | Pointer to the index of the listener registered. It is used as an input parameter of [OH_NativeDisplayManager_UnregisterFoldDisplayModeChangeListener](#oh_nativedisplaymanager_unregisterfolddisplaymodechangelistener).| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_UnregisterDisplayChangeListener()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_UnregisterDisplayChangeListener (uint32_t listenerIndex)
```

**Description**

Cancels the listening for status changes of the display.

**System capability**: SystemCapability.WindowManager.WindowManager.Core

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| listenerIndex | Index of the listener returned when [OH_NativeDisplayManager_RegisterDisplayChangeListener](#oh_nativedisplaymanager_registerdisplaychangelistener) is called.| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).


### OH_NativeDisplayManager_UnregisterFoldDisplayModeChangeListener()

```
NativeDisplayManager_ErrorCode OH_NativeDisplayManager_UnregisterFoldDisplayModeChangeListener (uint32_t listenerIndex)
```

**Description**

Cancels the listening for folded/unfolded state changes of the display.

**System capability**: SystemCapability.Window.SessionManager

**Since**: 12

**Parameters**

| Name| Description| 
| -------- | -------- |
| listenerIndex | Index of the listener returned when [OH_NativeDisplayManager_RegisterFoldDisplayModeChangeListener](#oh_nativedisplaymanager_registerfolddisplaymodechangelistener) is called.| 

**Returns**

Returns a status code defined in [NativeDisplayManager_ErrorCode](#nativedisplaymanager_errorcode).