Module java.desktop

软件包 java.awt

Class DisplayMode

java.lang.Object

java.awt.DisplayMode

public final class DisplayMode
extends Object

所述DisplayMode类封装的位深度，高度，宽度，和刷新速率GraphicsDevice 。 更改图形设备显示模式的能力取决于平台和配置，并不总是可用（参见GraphicsDevice.isDisplayChangeSupported() ）。

有关全屏独占模式API的更多信息，请参阅Full-Screen Exclusive Mode API Tutorial 。

从以下版本开始：

1.4

另请参见：

GraphicsDevice ， GraphicsDevice.isDisplayChangeSupported() ， GraphicsDevice.getDisplayModes() ， GraphicsDevice.setDisplayMode(java.awt.DisplayMode)

Field Summary

Fields

Modifier and Type	Field	描述
static int	BIT_DEPTH_MULTI	在该显示模式下支持多个位深度时，位深度的值。
static int	REFRESH_RATE_UNKNOWN	如果不知道刷新率的值。

构造方法摘要

构造方法

Constructor	描述
DisplayMode(int width, int height, int bitDepth, int refreshRate)	使用提供的参数创建一个新的显示模式对象。

方法摘要

Modifier and Type	方法	描述
boolean	equals(DisplayMode dm)	返回两种显示模式是否相等。
boolean	equals(Object dm)	指示一些其他对象是否等于此。
int	getBitDepth()	以像素为单位返回显示的位深度。
int	getHeight()	返回显示的高度，以像素为单位。
int	getRefreshRate()	以赫兹为单位返回显示刷新率。
int	getWidth()	返回显示的宽度，以像素为单位。
int	hashCode()	返回对象的哈希码值。
String	toString()	返回对象的字符串表示形式。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细信息

BIT_DEPTH_MULTI

@Native
public static final int BIT_DEPTH_MULTI

在该显示模式下支持多个位深度时，位深度的值。

另请参见：

getBitDepth() ， Constant Field Values

REFRESH_RATE_UNKNOWN

@Native
public static final int REFRESH_RATE_UNKNOWN

如果不知道刷新率的值。

另请参见：

getRefreshRate() ， Constant Field Values

构造方法详细信息

DisplayMode

public DisplayMode(int width,
                   int height,
                   int bitDepth,
                   int refreshRate)

使用提供的参数创建一个新的显示模式对象。

参数

width - 显示的宽度，以像素为单位

height - 显示的高度（以像素为单位）

bitDepth - 显示器的位深度，以像素为单位。 如果多个位深度可用，则可以为BIT_DEPTH_MULTI 。

refreshRate - 显示器的刷新率，单位为赫兹。 如果信息不可用，可以是REFRESH_RATE_UNKNOWN 。

另请参见：

BIT_DEPTH_MULTI ， REFRESH_RATE_UNKNOWN

方法详细信息

getHeight

public int getHeight()

返回显示的高度，以像素为单位。

结果

显示的高度，以像素为单位

getWidth

public int getWidth()

返回显示的宽度，以像素为单位。

结果

显示的宽度，以像素为单位

getBitDepth

public int getBitDepth()

以像素为单位返回显示的位深度。 如果在此显示模式下支持多个位深度，则可能为BIT_DEPTH_MULTI 。

结果

显示器的位深度（以像素为单位）。

另请参见：

BIT_DEPTH_MULTI

getRefreshRate

public int getRefreshRate()

以赫兹为单位返回显示刷新率。 如果信息不可用，可能是REFRESH_RATE_UNKNOWN 。

结果

显示器的刷新率（赫兹）。

另请参见：

REFRESH_RATE_UNKNOWN

equals

public boolean equals(DisplayMode dm)

返回两种显示模式是否相等。

参数

dm - 要比较的显示模式

结果

两种显示模式是否相等

equals

public boolean equals(Object dm)

指示一些其他对象是否等于此。

equals方法在非空对象引用上实现等价关系：

• 自反性 ：对于任何非空的参考值x ， x.equals(x)应该返回true 。
• 它是对称的 ：对于任何非空引用值x和y ， x.equals(y)应该返回true当且仅当y.equals(x)回报true 。
• 传递性 ：对于任何非空引用值x ， y ，并z ，如果x.equals(y)回报true和y.equals(z)回报true ，然后x.equals(z)应该返回true 。
• 它是一致的 ：对于任何非空引用值x和y ，在多次调用x.equals(y)始终返回true或始终返回false ，没有设置中使用的信息equals比较上的对象被修改。
• 对于任何非空的参考值x ， x.equals(null)应该返回false 。

该equals类方法Object实现对象上差别可能性最大的相等关系; 也就是说，对于任何非空参考值x和y ，当且仅当x和y引用相同对象（ x == y具有值true ）时，该方法返回true 。

请注意，无论何时覆盖此方法，通常需要覆盖hashCode方法，以便维护hashCode方法的通用合同，该方法规定相等的对象必须具有相等的哈希码。

重写：

equals在 Object

参数

dm - 与之比较的参考对象。

结果

true如果该对象与obj参数相同; 否则为false 。

另请参见：

Object.hashCode() ， HashMap

hashCode

public int hashCode()

返回对象的哈希码值。 支持这种方法有利于哈希表，如HashMap所提供的那样 。

hashCode的总合同是：

• 无论何时在执行Java应用程序时多次在同一个对象上调用该方法， hashCode方法必须始终返回相同的整数，前提是修改了equals对象中的信息。 该整数不需要从一个应用程序的执行到相同应用程序的另一个执行保持一致。
• 如果根据equals(Object)方法两个对象相等，则在两个对象中的每个对象上调用hashCode方法必须产生相同的整数结果。
• 不要求如果两个对象根据Object.equals(java.lang.Object)方法不相等，那么在两个对象中的每个对象上调用hashCode方法必须产生不同的整数结果。 但是，程序员应该意识到，为不等对象生成不同的整数结果可能会提高哈希表的性能。

尽可能合理实用，由类Object定义的hashCode方法确实为不同对象返回不同的整数。 （在某个时间点，hashCode可能或可能不被实现为对象的存储器地址的某些功能。）

重写：

hashCode在 Object

结果

该对象的哈希码值。

另请参见：

Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

toString

public String toString()

返回对象的字符串表示形式。 一般来说， toString方法返回一个字符串，“文本地表示”这个对象。 结果应该是一个简明扼要的表达，容易让人阅读。 建议所有子类覆盖此方法。

该toString类方法Object返回一个由类的名称，其中所述对象是其实例，该符号字符`的字符串@ ”，并且对象的哈希码的无符号的十六进制表示。 换句话说，这个方法返回一个等于下列值的字符串：

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

重写：

toString在 Object

结果

a string representation of the object.