鴻蒙OS Display

Display

java.lang.Object

|---ohos.agp.window.service.Display

public class Display
extends Object

封裝顯示屬性和操作。

DisplayManager.getDefaultDisplay(Context) 返回一個 Display 對象。

Since:

2

字段摘要

修飾符和類型	字段	描述
static int	STATE_DOZE	表示此屏幕正在打瞌睡。
static int	STATE_DOZE_SUSPEND	表示此屏幕正在打瞌睡，但 CPU 暫停更新它。
static int	STATE_OFF	表示此屏幕已關(guān)閉。
static int	STATE_ON	表示此屏幕已打開。
static int	STATE_ON_SUSPEND	表示此屏幕已打開，但 CPU 暫停更新它。
static int	STATE_UNKNOWN	表示此屏幕處于未知狀態(tài)。
static int	STATE_VR	表示此屏幕處于虛擬現(xiàn)實(shí)（VR）狀態(tài)。

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù)	描述
Display()	用于創(chuàng)建 Display 實(shí)例的構(gòu)造函數(shù)。

方法總結(jié)

修飾符和類型	方法	描述
DisplayAttributes	getAttributes()	獲取顯示的屬性。
void	getCurrentSizeRange(Point outSmallestSize, Point outLargestSize)	獲取顯示器的尺寸范圍，以像素為單位。
int	getDisplayId()	獲取顯示器的ID。
String	getDisplayName()	獲取顯示器的名稱。
int	getDisplayState()	獲取此顯示設(shè)備的狀態(tài)。
DisplayAttributes	getRealAttributes()	獲取顯示的實(shí)際屬性。
void	getRealSize(Point outSize)	獲取實(shí)際顯示尺寸。
float	getRefreshRate()	獲取此顯示設(shè)備每秒的屏幕刷新率。
int	getRotation()	獲取顯示器的旋轉(zhuǎn)度數(shù)。
void	getSize(Point outSize)	獲取顯示器的尺寸。
boolean	isAlive()	檢查此顯示設(shè)備是否處于活動狀態(tài)。

從類 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段詳細(xì)信息

STATE_DOZE

public static final int STATE_DOZE

表示此屏幕正在打瞌睡。

Since:

5

STATE_DOZE_SUSPEND

public static final int STATE_DOZE_SUSPEND

表示此屏幕正在打瞌睡，但 CPU 暫停更新它。

Since:

5

STATE_OFF

public static final int STATE_OFF

表示此屏幕已關(guān)閉。

Since:

5

STATE_ON

public static final int STATE_ON

表示此屏幕已打開。

Since:

5

STATE_ON_SUSPEND

public static final int STATE_ON_SUSPEND

表示此屏幕已打開，但 CPU 暫停更新它。

Since:

5

STATE_UNKNOWN

public static final int STATE_UNKNOWN

表示此屏幕處于未知狀態(tài)。

Since:

5

STATE_VR

public static final int STATE_VR

表示此屏幕處于虛擬現(xiàn)實(shí)（VR）狀態(tài)。

Since:

5

構(gòu)造函數(shù)詳細(xì)信息

Display

public Display()

用于創(chuàng)建 Display 實(shí)例的構(gòu)造函數(shù)。

方法詳情

getDisplayId

public int getDisplayId()

獲取顯示器的ID。

返回:

返回顯示 ID。

Throws:

Throw名稱	Throw描述
NullPointerException	如果 mDisplayWrapper 為 null，則引發(fā)此異常。

getDisplayName

public String getDisplayName()

獲取顯示器的名稱。

返回:

返回顯示名稱。

Throws:

Throw名稱	Throw描述
NullPointerException	如果 mDisplayWrapper 為 null，則引發(fā)此異常。

getRotation

public int getRotation()

獲取顯示器的旋轉(zhuǎn)度數(shù)。 旋轉(zhuǎn)度由枚舉值表示。 0 表示不旋轉(zhuǎn)，1 表示 90 度，2 表示 180 度，3 表示 270 度。

返回:

返回顯示器的旋轉(zhuǎn)度數(shù)。

Throws:

Throw名稱	Throw描述
NullPointerException	如果 mDisplayWrapper 為 null，則引發(fā)此異常。

getAttributes

public DisplayAttributes getAttributes()

獲取顯示的屬性。 導(dǎo)航欄的寬度和高度不包括在內(nèi)。

返回:

返回顯示的屬性。

Throws:

Throw名稱	Throw描述
NullPointerException	如果 mDisplayWrapper 為 null，則引發(fā)此異常。

getRealAttributes

public DisplayAttributes getRealAttributes()

獲取顯示的實(shí)際屬性。

返回:

返回顯示的實(shí)際屬性。

Throws:

Throw名稱	Throw描述
NullPointerException	如果 mDisplayWrapper 為 null，則引發(fā)此異常。

getCurrentSizeRange

public void getCurrentSizeRange(Point outSmallestSize, Point outLargestSize)

獲取顯示器的尺寸范圍，以像素為單位。

此方法獲得所有方向上預(yù)期顯示的最大和最小尺寸。 得到的顯示范圍保存在該方法的參數(shù)中。

參數(shù)：

參數(shù)名稱	參數(shù)描述
outSmallestSize	指示最小顯示尺寸。
outLargestSize	指示最大顯示尺寸。

Throws:

Throw名稱	Throw描述
NullPointerException	如果 mDisplayWrapper 為 null，則引發(fā)此異常。

getSize

public void getSize(Point outSize)

獲取顯示器的尺寸。

此方法可能不會返回顯示的實(shí)際大小。 例如，如果始終顯示狀態(tài)欄，則返回值已排除狀態(tài)欄的大小，或者該值與已縮放以適應(yīng)小屏幕設(shè)備的顯示相匹配。

參數(shù)：

參數(shù)名稱	參數(shù)描述
outSize	表示顯示尺寸。

Throws:

Throw名稱	Throw描述
NullPointerException	如果 mDisplayWrapper 為 null，則引發(fā)此異常。

getRealSize

public void getRealSize(Point outSize)

獲取實(shí)際顯示尺寸。

返回值包括狀態(tài)欄的大小，沒有任何比例。

參數(shù)：

參數(shù)名稱	參數(shù)描述
outSize	指示顯示器的實(shí)際尺寸。

Throws:

Throw名稱	Throw描述
NullPointerException	如果 mDisplayWrapper 為 null，則引發(fā)此異常。

getRefreshRate

public float getRefreshRate()

獲取此顯示設(shè)備每秒的屏幕刷新率。

返回:

返回每秒的屏幕刷新率，以 Hz 為單位。

Throws:

Throw名稱	Throw描述
NullPointerException	如果 mDisplayWrapper 為 null，則引發(fā)此異常。

Since:

5

getDisplayState

public int getDisplayState()

獲取此顯示設(shè)備的狀態(tài)。

返回:

返回顯示設(shè)備狀態(tài)，可以是 STATE_OFF、STATE_ON、STATE_DOZE、STATE_DOZE_SUSPEND、STATE_ON_SUSPEND 或 STATE_UNKNOWN。

Throws:

Throw名稱	Throw描述
NullPointerException	如果 mDisplayWrapper 為 null，則引發(fā)此異常。

Since:

5

isAlive

public boolean isAlive()

檢查此顯示設(shè)備是否處于活動狀態(tài)。

返回:

如果此顯示設(shè)備處于活動狀態(tài)，則返回 true； 如果移除此顯示設(shè)備，則返回 false。

Throws:

Throw名稱	Throw描述
NullPointerException	如果 mDisplayWrapper 為 null，則引發(fā)此異常。

Since:

5